StarUML活动图MCP服务器

StarUML Controller MCP Server — Activity Diagram

An MCP (Model Context Protocol) server specialized for Activity Diagrams. Enables AI assistants like Claude to programmatically create and manage activity diagrams — actions, control nodes, object nodes, partitions, control flows, and object flows in StarUML.

Example: "Online Order Processing" activity diagram generated entirely via MCP tools — featuring swimlanes, fork/join parallelism, decision/merge branching, interruptible & expansion regions, exception handlers, input/output pins, and all 8 control node types.

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-activity-mcp.git
cd staruml-controller-activity-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 Activity Diagram tools become available via MCP

4. Configure your AI assistant

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

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

Or via CLI:

claude mcp add staruml-activity -e STARUML_PASSWORD=<password> -- node /absolute/path/to/staruml-controller-activity-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-activity": {
      "command": "node",
      "args": ["/absolute/path/to/staruml-controller-activity-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.

Activity Diagram Tools

The core of this server — full CRUD for every Activity 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