Which integrations are available for this server?

Allows importing Mermaid diagram definitions into StarUML.

How do I use staruml-controller-sysml-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@staruml-controller-sysml-mcp Create a SysML requirements diagram for the infusion pump project" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

staruml-controller-sysml-mcp

by pontasan

Overview Schema Source Related Servers Discussions Admin

Local

StarUML Controller MCP Server — SysML Diagram

An MCP (Model Context Protocol) server specialized for SysML Diagrams. Enables AI assistants like Claude to programmatically create and manage SysML diagrams — requirements, blocks (with properties, operations, flow properties), stakeholders, viewpoints, views, parts, and various relationship types in StarUML.

Medical Infusion Pump System — Requirements diagram with traceability (deriveReqt, satisfy) generated entirely through MCP tool calls

Architecture

Related MCP server: StarUML MCP Server

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-sysml-mcp.git
cd staruml-controller-sysml-mcp
npm install && npm run build

3. Start the StarUML Controller Server

Launch StarUML and open a project (or create a new one)
From the menu bar, select Tools > StarUML Controller > Start Server...
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
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
All SysML Diagram tools become available via MCP

4. Configure your AI assistant

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

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

Or via CLI:

claude mcp add staruml-sysml -e STARUML_PASSWORD=<password> -- node /absolute/path/to/staruml-controller-sysml-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-sysml": {
      "command": "node",
      "args": ["/absolute/path/to/staruml-controller-sysml-mcp/dist/index.js"],
      "env": { "STARUML_PASSWORD": "<password>" }
    }
  }
}

Restart your AI assistant.

Available Tools

All tools accept optional host and port parameters. Their defaults come from environment variables of the MCP server:

Variable	Required	Description
`STARUML_PASSWORD`	Yes	The password entered when the StarUML Controller server was started
`STARUML_HOST`	No	Host of the machine running StarUML (default: `localhost`)
`STARUML_PORT`	No	Port of the StarUML Controller server (default: `12345`)

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.

SysML Diagram Tools

The core of this server — full CRUD for every SysML Diagram resource.

Resource	Tools
Diagrams	`sysml_list_diagrams`, `sysml_create_diagram`, `sysml_get_diagram`, `sysml_update_diagram`, `sysml_delete_diagram`
Requirements	`sysml_list_requirements`, `sysml_create_requirement`, `sysml_get_requirement`, `sysml_update_requirement`, `sysml_delete_requirement`
Blocks	`sysml_list_blocks`, `sysml_create_block`, `sysml_get_block`, `sysml_update_block`, `sysml_delete_block`
— Properties	`sysml_list_block_properties`, `sysml_create_block_property`
— Operations	`sysml_list_block_operations`, `sysml_create_block_operation`
— Flow Properties	`sysml_list_block_flow_properties`, `sysml_create_block_flow_property`
Stakeholders	`sysml_list_stakeholders`, `sysml_create_stakeholder`, `sysml_get_stakeholder`, `sysml_update_stakeholder`, `sysml_delete_stakeholder`
Viewpoints	`sysml_list_viewpoints`, `sysml_create_viewpoint`, `sysml_get_viewpoint`, `sysml_update_viewpoint`, `sysml_delete_viewpoint`
Views	`sysml_list_views`, `sysml_create_view`, `sysml_get_view`, `sysml_update_view`, `sysml_delete_view`
Parts	`sysml_list_parts`, `sysml_create_part`, `sysml_get_part`, `sysml_update_part`, `sysml_delete_part`
Conforms	`sysml_list_conforms`, `sysml_create_conform`, `sysml_get_conform`, `sysml_update_conform`, `sysml_delete_conform`
Exposes	`sysml_list_exposes`, `sysml_create_expose`, `sysml_get_expose`, `sysml_update_expose`, `sysml_delete_expose`
Copies	`sysml_list_copies`, `sysml_create_copy`, `sysml_get_copy`, `sysml_update_copy`, `sysml_delete_copy`
Derive Reqts	`sysml_list_derive_reqts`, `sysml_create_derive_reqt`, `sysml_get_derive_reqt`, `sysml_update_derive_reqt`, `sysml_delete_derive_reqt`
Verifies	`sysml_list_verifies`, `sysml_create_verify`, `sysml_get_verify`, `sysml_update_verify`, `sysml_delete_verify`
Satisfies	`sysml_list_satisfies`, `sysml_create_satisfy`, `sysml_get_satisfy`, `sysml_update_satisfy`, `sysml_delete_satisfy`
Refines	`sysml_list_refines`, `sysml_create_refine`, `sysml_get_refine`, `sysml_update_refine`, `sysml_delete_refine`
Connectors	`sysml_list_connectors`, `sysml_create_connector`, `sysml_get_connector`, `sysml_update_connector`, `sysml_delete_connector`

Common Tools

Shared infrastructure tools available across all StarUML Controller MCP servers.

Tool	Description
`get_status`	Get server status, version, and endpoint list
`get_element`	Get any element by ID
`list_element_tags`	List tags on an element
`create_element_tag`	Create a tag on an element
`get_tag`	Get tag details
`update_tag`	Update a tag
`delete_tag`	Delete a tag
`save_project`	Save project to a .mdj file
`open_project`	Open a .mdj project file

Tool	Description
`project_new`	Create a new empty project
`project_close`	Close the current project
`project_import`	Import a .mdj fragment into the project
`project_export`	Export a model fragment to a .mdj file
`project_export_all`	Export all diagrams as images (PNG/SVG/JPEG/PDF)
`project_export_doc`	Export project documentation (HTML/Markdown)

Tool	Description
`undo`	Undo the last action
`redo`	Redo the last undone action
`search`	Search elements by keyword with optional type filter
`validate`	Run model validation
`mermaid_import`	Import a Mermaid diagram definition
`generate_diagram`	Generate a diagram from natural language (requires AI extension)

Tool	Description
`diagram_list`	List all diagrams (optionally filter by type)
`diagram_create`	Create a new diagram of any type
`diagram_get`	Get diagram details by ID
`diagram_update`	Update diagram name
`diagram_delete`	Delete a diagram
`diagram_list_elements`	List all elements on a diagram
`diagram_list_views`	List all views on a diagram
`diagram_create_element`	Create a node element on a diagram
`diagram_create_relation`	Create a relation between elements
`diagram_export`	Export diagram as image (PNG/SVG/JPEG/PDF)
`diagram_layout`	Auto-layout diagram with configurable direction
`diagram_open`	Open/activate a diagram in the editor
`diagram_zoom`	Set diagram zoom level
`diagram_create_view_of`	Create a view of an existing model on a diagram
`diagram_link_object`	Create a UMLLinkObject on an object diagram

Tool	Description
`note_list`	List all notes on a diagram
`note_create`	Create a note with text and position
`note_get`	Get note details
`note_update`	Update note text
`note_delete`	Delete a note
`note_link_list`	List all note links on a diagram
`note_link_create`	Create a link between a note and an element
`note_link_delete`	Delete a note link
`free_line_list`	List all free lines on a diagram
`free_line_create`	Create a free line on a diagram
`free_line_delete`	Delete a free line
`shape_list`	List all shapes on a diagram
`shape_create`	Create a shape (Text, TextBox, Rect, RoundRect, Ellipse, Hyperlink, Image)
`shape_get`	Get shape details
`shape_update`	Update shape text
`shape_delete`	Delete a shape

Tool	Description
`view_update`	Move/resize a view (left, top, width, height)
`view_update_style`	Update visual style (fillColor, lineColor, fontColor, fontSize, etc.)
`view_reconnect`	Reconnect an edge to different source/target
`view_align`	Align/distribute multiple views
`element_update`	Update any element's name and documentation
`element_delete`	Delete any element by ID
`element_list_relationships`	List all relationships of an element
`element_list_views`	List all views of an element across diagrams
`element_relocate`	Move element to a different parent
`element_create_child`	Create a child element (attribute, operation, etc.)
`element_reorder`	Reorder element within parent (up/down)

This server is part of the StarUML Controller MCP family:

Server	Diagram Type
staruml-controller-erd-mcp	Entity-Relationship Diagram
staruml-controller-seq-mcp	Sequence Diagram
staruml-controller-class-mcp	Class / Package Diagram
staruml-controller-usecase-mcp	Use Case Diagram
staruml-controller-activity-mcp	Activity Diagram
staruml-controller-bpmn-mcp	BPMN Diagram
staruml-controller-sysml-mcp	SysML Diagram
and 18 more...

All servers share common tools and add diagram-specific tools on top. Install only what you need.

License

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

ApricotOAuth
tools.apricot
Manage SysML2 projects and files directly through your coding agent.
Developer Tools File Systems
1
flowzap B
io.github.flowzap-xyz
Create workflow, sequence, architecture, and mind map diagrams via AI assistants.
Software Architecture Developer Tools Workplace & Productivity
1315
trident A
io.github.alexeibespalov
Create and edit collaborative architecture diagrams with any AI assistant using the Trident 2D DSL.
Software Architecture Developer Tools
232
hustcc-mcp-mermaid
ai.smithery
Generate dynamic Mermaid diagrams and charts with AI assistance. Customize styles and export diagr…
Software Architecture Developer Tools App Automation
2642

Related MCP Servers

StarUML MCP Serverofficial
Software Architecture Developer Tools
staruml
A
license
A
quality
C
maintenance
Enables creating diagrams or generating code from diagrams in StarUML via prompts.
Updated a year ago (2025-07-17 09:34 UTC)
4
73 npm
23
MIT
StarUML MCP Server
Software Architecture Developer Tools
StoneSho
F
license
Not graded
quality
D
maintenance
Enables AI to remotely control StarUML for generating UML diagrams (use case, class, sequence, ER, etc.) via MCP protocol or REST API.
Updated 4 months ago (2026-05-28 16:13 UTC)
-
Draw.io MCP Server
Design Tools Software Architecture Data Visualization
yohasacura
A
license
Not graded
quality
C
maintenance
Enables AI assistants to create and edit draw.io diagrams programmatically, supporting a wide range of diagram types and styles.
Updated 8 months ago (2026-02-09 17:50 UTC)
107 PyPI
5
MIT
StarUML Controller InfoFlow
Software Architecture Developer Tools
pontasan
F
license
Not graded
quality
B
maintenance
Enables AI assistants to programmatically create and manage information flow diagrams — information items and information flows in StarUML.
Updated 18 days ago (2026-09-21 11:31 UTC)
-