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 18+
StarUML with the staruml-controller extension installed and running

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...
Enter a port (default: 12345) and click OK
The HTTP server starts — 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"]
    }
  }
}

Or via CLI:

claude mcp add staruml-sysml 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"]
    }
  }
}

Restart your AI assistant.

Available Tools

All tools accept optional host (default: localhost) and port (default: 12345) parameters.

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

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

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.
1
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
2632
Stellary Project Management MCP ServerOAuth
io.github.Anymfah
Connect AI assistants to Stellary projects, boards, documents, and governed agent workflows.
Project Management Agent Orchestration
2

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
19 npm
20
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 7 months ago (2026-02-09 17:50 UTC)
5
MIT
StarUML Controller InfoFlow
Software Architecture Developer Tools
pontasan
F
license
Not graded
quality
C
maintenance
Enables AI assistants to programmatically create and manage information flow diagrams — information items and information flows in StarUML.
Updated 7 months ago (2026-02-17 02:14 UTC)
-