Staruml Mcp
Connects Claude or any MCP client to StarUML's API server over stdio or HTTP, exposing 19 tools split across built-in and extension endpoints. The base four tools handle Mermaid-to-UML generation and diagram exports. Install the companion staruml-mcp-extension and you unlock project save/open, element CRUD, diagram switching, and execution of StarUML's 138 built-in commands. Useful when you want AI agents to scaffold class diagrams, ERDs, or sequence diagrams directly in StarUML instead of producing static text. Requires StarUML 7.0+ with the API server enabled on port 58321. The HTTP transport runs on 58323 by default, making it simple to wire up with Claude Code or Cursor.
- tools
- 19
- transport
- STDIO
- last updated
- Apr 20, 2026
Tools
19 toolsPublic tool metadata for what this MCP can expose to an agent.
generate_diagramGenerate a UML diagram from Mermaid code.
Generate a UML diagram from Mermaid code.
No parameter schema in public metadata yet.
get_all_diagrams_infoList all diagrams in the current project (id, name, type).
List all diagrams in the current project (id, name, type).
No parameter schema in public metadata yet.
get_current_diagram_infoGet metadata of the currently focused diagram.
Get metadata of the currently focused diagram.
No parameter schema in public metadata yet.
get_diagram_image_by_idExport a diagram as PNG by its ID.
Export a diagram as PNG by its ID.
No parameter schema in public metadata yet.
get_all_commandsList all 138+ built-in StarUML command IDs.
List all 138+ built-in StarUML command IDs.
No parameter schema in public metadata yet.
execute_commandExecute any built-in command (e.g. `project:save`, `view:fit-to-window`).
Execute any built-in command (e.g. `project:save`, `view:fit-to-window`).
No parameter schema in public metadata yet.
get_project_infoCurrent project's filename + top-level elements.
Current project's filename + top-level elements.
No parameter schema in public metadata yet.
save_projectProject file lifecycle.
Project file lifecycle.
No parameter schema in public metadata yet.
save_project_asProject file lifecycle.
Project file lifecycle.
No parameter schema in public metadata yet.
new_projectProject file lifecycle.
Project file lifecycle.
No parameter schema in public metadata yet.
open_projectProject file lifecycle.
Project file lifecycle.
No parameter schema in public metadata yet.
get_element_by_idQuery model elements.
Query model elements.
No parameter schema in public metadata yet.
find_elementsQuery model elements.
Query model elements.
No parameter schema in public metadata yet.
create_elementElement CRUD.
Element CRUD.
No parameter schema in public metadata yet.
update_elementElement CRUD.
Element CRUD.
No parameter schema in public metadata yet.
delete_elementElement CRUD.
Element CRUD.
No parameter schema in public metadata yet.
create_diagramDiagram management (typed native).
Diagram management (typed native).
No parameter schema in public metadata yet.
switch_diagramDiagram management.
Diagram management.
No parameter schema in public metadata yet.
close_diagramDiagram management.
Diagram management.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
staruml-mcp
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.
How it fits together
AI Agent ──MCP──► staruml-mcp (this package) ──HTTP──► StarUML
:58321 (built-in, 4 tools)
:58322 (extension, 15 tools)
Details
- Repository
- github.com/ezrabrilliant/staruml-mcp
- Package
staruml-mcp- Transport
- STDIO
- Registry
- MCP registry, active