Skip to main content
Glama
pontasan

staruml-controller-sysml-mcp

by pontasan

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

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"]
    }
  }
}
  1. 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

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pontasan/staruml-controller-sysml-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server