Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"io-github-ezrabrilliant-staruml-mcp": {
"args": [
"-y",
"staruml-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Model Context Protocol (MCP) server for StarUML. Lets AI agents (Claude Code, Cursor, VS Code Copilot, Codex) drive StarUML programmatically — generate UML diagrams from Mermaid, execute any built-in command, CRUD elements, save projects, and more.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'staruml-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked staruml-mcp against OSV.dev.
Click any tool to inspect its schema.
Create ER diagramCreate an ER diagram in StarUML for a POS database: users, menus, transactions with relationships.
Generate sequence diagramGenerate a sequence diagram for JWT login: frontend → /api/auth/login → AuthService → DB → JWT response.
Show current diagramShow me the current diagram in StarUML.
Export diagram as imageExport diagram with ID as an image.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in developer-tools / design
A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Manage Supabase projects — databases, auth, storage, and edge functions
Copy/paste detector for programming source code, supports 223 formats. AI-ready with token-efficient reporter, skill and MCP server.
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
MCP Security Weekly
Get CVE alerts and security updates for io.github.ezrabrilliant/staruml-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Model Context Protocol (MCP) server for StarUML. Lets AI agents (Claude Code, Cursor, VS Code Copilot, Codex) drive StarUML programmatically — generate UML diagrams from Mermaid, execute any built-in command, CRUD elements, save projects, and more.
AI Agent ──MCP──► staruml-mcp (this package) ──HTTP──► StarUML
:58321 (built-in, 4 tools)
:58322 (extension, 15 tools)
| Package | What it is | Where it runs |
|---|---|---|
staruml-mcp (this repo) | MCP server for AI agents | your machine via npx -y staruml-mcp |
staruml-mcp-extension | StarUML plugin adding 15 HTTP endpoints | inside StarUML (install once via Extension Manager) |
staruml-mcp only. The 4 built-in tools work.staruml-mcp-extension installed in StarUML — required for 15 of the 19 toolsEdit settings.json at:
%APPDATA%\StarUML\settings.json~/Library/Application Support/StarUML/settings.json~/.config/StarUML/settings.jsonAdd or update:
{
"apiServer": true,
"apiServerPort": 58321
}
Restart StarUML.
Verify:
curl http://localhost:58321/
# → "Hello from StarUML API Server!"
Start the server in a terminal:
npx -y staruml-mcp --transport http
# listens on http://localhost:58323/mcp by default
Register with Claude Code:
claude mcp add --transport http staruml http://localhost:58323/mcp
Port
58323is the canonical HTTP port, chosen to sit alongside StarUML's built-in API (58321) andstaruml-mcp-extension(58322). Override with--port <n>if needed.
Restart Claude Code. Ask:
"What StarUML tools do you have?"
Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"staruml": {
"command": "npx",
"args": ["-y", "staruml-mcp"]
}
}
}
Restart Claude Desktop.
Point your MCP client at npx -y staruml-mcp (stdio) or http://localhost:58323/mcp (HTTP).
staruml-mcp [options]
-t, --transport <type> stdio | http (default: stdio)
-p, --port <number> HTTP listen port (default: 58323)
--api-port <number> StarUML built-in API port (default: 58321)
--ext-port <number> staruml-mcp-extension port(default: 58322)
--api-host <url> StarUML API host prefix (default: http://localhost)
-V, --version Print version
-h, --help Show help
| Tool | Description |
|---|---|
generate_diagram | Generate a UML diagram from Mermaid code. |
| `get_all_diagra |