Staruml Controller Sysml

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

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

1. Launch StarUML and open a project (or create a new one)
2. From the menu bar, select Tools > StarUML Controller > Start Server...
3. Enter a port (default: 12345) and click OK
4. 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"]
    }
  }
}

5. 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.

General — status, elements, tags, project I/O

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

Project — new, close, import, export

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)

Utility — undo, redo, search, validate, mermaid, generate

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)

Diagrams — CRUD, export, layout, zoom

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

Notes & Shapes — notes, note links, free lines, shapes

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

Views & Elements — positioning, styling, element management

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)

Related Projects

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