StarUML 复合结构图 MCP 服务器

StarUML Controller MCP Server — Composite Structure Diagram

An MCP (Model Context Protocol) server specialized for Composite Structure Diagrams. Enables AI assistants like Claude to programmatically create and manage composite structure diagrams — ports, parts, collaborations, collaboration uses, role bindings, dependencies, and realizations in StarUML.

SmartHome System composite structure diagram — created entirely via MCP tools

Architecture

Prerequisites

• Node.js 20+
• StarUML with the staruml-controller extension 2.x installed and running

Upgrading from 1.x: version 2 needs the staruml-controller extension 2.x, which requires a password. Update the extension, staruml-controller-mcp-core and this package together. Pull and rebuild staruml-controller-mcp-core first, then this package.

Setup

1. Clone and build the core package

git clone https://github.com/pontasan/staruml-controller-mcp-core.git
cd staruml-controller-mcp-core
npm install && npm run build
cd ..

2. Clone and build this package

git clone https://github.com/pontasan/staruml-controller-composite-mcp.git
cd staruml-controller-composite-mcp
npm install && npm run build

3. Start the StarUML Controller Server

1. Launch StarUML and open a project (or create a new one)
2. From the menu bar, select Tools > StarUML Controller > Start Server...
3. A dialog asks for the port (default: 12345) and the password. A random UUID is filled in as the password automatically; keep it, press Regenerate for a new one, or type your own. Click Start Server
4. The HTTP server starts and the password is copied to the clipboard, so you can paste it into the MCP server setting (STARUML_PASSWORD). The password is remembered for the next start. To copy it again or to change it, stop the server and open Start Server... again: the dialog shows the password with Copy and Regenerate buttons
5. All Composite Structure Diagram tools become available via MCP

4. Configure your AI assistant

Claude Code — add to your project's .mcp.json:

{
  "mcpServers": {
    "staruml-composite": {
      "command": "node",
      "args": ["/absolute/path/to/staruml-controller-composite-mcp/dist/index.js"],
      "env": { "STARUML_PASSWORD": "<password>" }
    }
  }
}

Or via CLI:

claude mcp add staruml-composite -e STARUML_PASSWORD=<password> -- node /absolute/path/to/staruml-controller-composite-mcp/dist/index.js

Claude Desktop — add to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "staruml-composite": {
      "command": "node",
      "args": ["/absolute/path/to/staruml-controller-composite-mcp/dist/index.js"],
      "env": { "STARUML_PASSWORD": "<password>" }
    }
  }
}

5. Restart your AI assistant.

Available Tools

All tools accept optional host and port parameters. Their defaults come from environment variables of the MCP server:

The password is never a tool parameter, so it does not pass through the AI conversation.

File paths: tools that write or read files (diagram_export, project_export, project_export_all, project_export_doc, project_import) use a path on the machine running this MCP server. save_project and open_project use a path on the machine running StarUML.

Composite Structure Diagram Tools

The core of this server — full CRUD for every Composite Structure Diagram resource.

Common Tools

Shared infrastructure tools available across all StarUML Controller MCP servers.

Related Projects

This server is part of the StarUML Controller MCP family:

All servers share common tools and add diagram-specific tools on top. Install only what you need.

License

MIT