staruml

StarUML MCP Server exposes a set of tools to interact with StarUML diagrams from Claude’s MCP workflow. The server can generate diagrams, retrieve information about the current or all diagrams, and fetch diagram images by ID. You can invoke the tools via prompts like “Create a class diagram for … in StarUML” or “Generate SQL DDL from the current ERD diagram in StarUML” and the MCP server will orchestrate StarUML actions accordingly. The available tools include generate_diagram, get_current_diagram_info, get_all_diagrams_info, and get_diagram_image_by_id, enabling both creation and inspection of diagrams as well as embedding diagram visuals when needed.

Prerequisites

• Node.js v22 or higher
• StarUML v7.0.0 or higher

Installation steps

1. Ensure Node.js and StarUML are installed and accessible on your system.

2. Install the MCP server via npx using the provided configuration:

   • Run Claude Desktop or your preferred environment configuration file setup (claude_desktop_config.json) with the following:

     { "mcpServers": { "staruml-mcp-server": { "command": "npx", "args": ["-y", "staruml-mcp-server"] } } }

3. If you want to run the server directly for development, install dependencies and build:

   • git clone <repository-url>
   • cd staruml-mcp-server
   • npm install
   • npm run build

4. Optionally, configure a custom API port by passing --api-port=<port> when starting StarUML via the MCP server, if required.

5. Update Claude Desktop configuration to point to the built server as shown in the README, then restart Claude Desktop.

Environment and configuration tips:

• API Port: You can change the API server port with --api-port=<port> when launching the StarUML MCP server.
• Claude Desktop config: Update claude_desktop_config.json to reference the server entry (e.g., staruml-mcp-server) with command: node and the path to build/index.js if you build locally.
• If using npx, the first run may take a moment as the package is installed temporarily.
• Ensure StarUML is running (or accessible) if the MCP server relies on a live StarUML session.
• The npm package name is staruml-mcp-server, which is used with npx as shown in the config.
• When debugging, use npm run build to compile TypeScript/JS sources as defined by the project’s build script.