BPMN图管理MCP服务器

StarUML Controller MCP Server — BPMN Diagram

An MCP (Model Context Protocol) server specialized for BPMN Diagrams. Enables AI assistants like Claude to programmatically create and manage BPMN diagrams — participants, lanes, tasks, sub-processes, events, gateways, data objects, conversations, choreographies, and all flow types in StarUML.

Example: An EC Order Processing diagram created entirely via MCP tools — featuring 3 pools, 3 lanes, 9 task types, 5 event types, 5 gateway types, sub-processes, data objects, choreographies, conversations, and cross-pool message flows.

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

4. Configure your AI assistant

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

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

Or via CLI:

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

BPMN Diagram Tools

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