StarUML Controller MCP Server — Use Case Diagram

An MCP (Model Context Protocol) server specialized for Use Case Diagrams. Enables AI assistants like Claude to programmatically create and manage use case diagrams — actors, use cases (with extension points), subjects, associations, includes, extends, generalizations, and dependencies in StarUML.

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-usecase-mcp.git
cd staruml-controller-usecase-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 Use Case Diagram tools become available via MCP

4. Configure your AI assistant

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

{
  "mcpServers": {
    "staruml-usecase": {
      "command": "node",
      "args": ["/absolute/path/to/staruml-controller-usecase-mcp/dist/index.js"]
    }
  }
}

Or via CLI:

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

Restart your AI assistant.

Available Tools

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

Use Case Diagram Tools

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

| Resource | Tools | |---|---| | Diagrams | usecase_list_diagrams, usecase_create_diagram, usecase_get_diagram, usecase_update_diagram, usecase_delete_diagram | | Actors | usecase_list_actors, usecase_create_actor, usecase_get_actor, usecase_update_actor, usecase_delete_actor | | Use Cases | usecase_list_use_cases, usecase_create_use_case, usecase_get_use_case, usecase_update_use_case, usecase_delete_use_case | | — Extension Points | usecase_list_use_case_extension_points, usecase_create_use_case_extension_point | | Subjects | usecase_list_subjects, usecase_create_subject, usecase_get_subject, usecase_update_subject, usecase_delete_subject | | Associations | usecase_list_associations, usecase_create_association, usecase_get_association, usecase_update_association, usecase_delete_association | | Includes | usecase_list_includes, usecase_create_include, usecase_get_include, usecase_update_include, usecase_delete_include | | Extends | usecase_list_extends, usecase_create_extend, usecase_get_extend, usecase_update_extend, usecase_delete_extend | | Generalizations | usecase_list_generalizations, usecase_create_generalization, usecase_get_generalization, usecase_update_generalization, usecase_delete_generalization | | Dependencies | usecase_list_dependencies, usecase_create_dependency, usecase_get_dependency, usecase_update_dependency, usecase_delete_dependency |

Common Tools

Shared infrastructure tools available across all StarUML Controller MCP servers.

<details> <summary>General — status, elements, tags, project I/O</summary>

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

</details>

<details> <summary>Project — new, close, import, export</summary>

| 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) |

</details>

<details> <summary>Utility — undo, redo, search, validate, mermaid, generate</summary>

| 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) |

</details>

<details> <summary>Diagrams — CRUD, export, layout, zoom</summary>

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

</details>

<details> <summary>Notes & Shapes — notes, note links, free lines, shapes</summary>

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

</details>

<details> <summary>Views & Elements — positioning, styling, element management</summary>

| 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) |

</details>

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

StarUML Controller MCP Server — Use Case Diagram

StarUML Controller MCP Server — Use Case Diagram

Architecture

Prerequisites

Setup

1. Clone and build the core package

2. Clone and build this package

3. Start the StarUML Controller Server

4. Configure your AI assistant

Available Tools

Use Case Diagram Tools

Common Tools

Related Projects

License

Related MCP servers

MCP servers by category