StarUML控制器MCP核心库

src/
  index.ts                  # Public API exports
  server-factory.ts         # createServer(name, version, familyTools) → McpServer
  stdio-runner.ts           # runStdioServer(name, version, familyTools) — serve over stdio
  tool-registry.ts          # registerAll(server, tools) — declarative tool registration
  config.ts                 # STARUML_PASSWORD / STARUML_HOST / STARUML_PORT
  http-client.ts            # request(method, host, port, path, body) — REST client (sends the password)
  file-transfer.ts          # write / read files on the machine running the MCP server
  response-formatter.ts     # format(response), formatError(name, error)
  tools/
    general.ts              # get_status, get_element, tags, save/open project
    project.ts              # project_new, project_close, import, export
    utility.ts              # undo, redo, search, validate, mermaid_import, generate_diagram
    diagrams.ts             # diagram CRUD, export, layout, zoom, create_view_of
    notes.ts                # notes, note links, free lines
    shapes.ts               # shape CRUD (Text, Rect, Ellipse, Image, etc.)
    views.ts                # view position/style, reconnect, align
    elements.ts             # element update/delete, children, relocate, reorder
    family-factory.ts       # generateFamilyTools(config) — declarative tool generator
    families/
      types.ts              # FamilyConfig, ResourceConfig, RelationConfig, etc.
      erd.ts                # ERD family (data models, entities, columns, relationships, DDL)
      seq.ts                # Sequence family (interactions, lifelines, messages, fragments)
      class.ts              # Class/Package family
      usecase.ts            # Use Case family
      activity.ts           # Activity family
      statemachine.ts       # State Machine family
      component.ts          # Component family
      deployment.ts         # Deployment family
      object.ts             # Object family
      communication.ts      # Communication family
      composite.ts          # Composite Structure family
      infoflow.ts           # Information Flow family
      profile.ts            # Profile family
      timing.ts             # Timing family
      overview.ts           # Interaction Overview family
      flowchart.ts          # Flowchart family
      dfd.ts                # DFD family
      bpmn.ts               # BPMN family
      c4.ts                 # C4 family
      sysml.ts              # SysML family
      wireframe.ts          # Wireframe family
      mindmap.ts            # MindMap family
      aws.ts                # AWS family
      azure.ts              # Azure family
      gcp.ts                # GCP family

#!/usr/bin/env node
import { runStdioServer, erdTools } from "staruml-controller-mcp-core"

runStdioServer(
  "staruml-controller-erd",
  "2.0.0",
  erdTools       // diagram-specific tools
)

import { generateFamilyTools, type FamilyConfig } from "staruml-controller-mcp-core"

const config: FamilyConfig = {
  prefix: "mydiagram",
  label: "My Diagram",
  diagrams: { types: ["MyDiagramType"] },
  resources: [
    { name: "nodes", types: ["MyNode"], createFields: ["name", "label"] }
  ],
  relations: [
    { name: "edges", type: "MyEdge" }
  ],
}

const tools = generateFamilyTools(config)

// Infrastructure
import { request, encodeId } from "staruml-controller-mcp-core"
import { format, formatError } from "staruml-controller-mcp-core"
import { registerAll, type ToolDefinition } from "staruml-controller-mcp-core"

// Common tool arrays
import { generalTools, diagramTools, noteTools } from "staruml-controller-mcp-core"

// Family configs
import { erdTools, seqTools, classTools } from "staruml-controller-mcp-core"

// Type definitions
import type { FamilyConfig, ResourceConfig, RelationConfig } from "staruml-controller-mcp-core"

npm install
npm run build

# tools/list over stdio, with the 2026-07-28 protocol or the earlier handshake
node test/list-tools.mjs ../staruml-controller-erd-mcp/dist/index.js modern
node test/list-tools.mjs ../staruml-controller-erd-mcp/dist/index.js legacy

# End-to-end through the MCP layer (StarUML must be running with the controller server started)
STARUML_PASSWORD=<password> node test/smoke-erd.mjs ../staruml-controller-erd-mcp/dist/index.js modern

# Any diagram-specific server: get_status, all list tools, diagram create/get/update/delete
STARUML_PASSWORD=<password> node test/smoke-family.mjs ../staruml-controller-class-mcp/dist/index.js modern