Which integrations are available for this server?

Provides a tool to import Mermaid diagram definitions into StarUML ER diagrams. Generates PostgreSQL DDL from Entity-Relationship diagrams, enabling database schema creation.

How do I use staruml-controller-erd-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-erd-mcp Create a User entity with id, email, and password columns." 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-erd-mcp

by pontasan

Overview Schema Source Related Servers Discussions Admin

Local

StarUML Controller MCP Server — ERD

An MCP (Model Context Protocol) server specialized for Entity-Relationship Diagrams. Enables AI assistants like Claude to programmatically create and manage ER diagrams in StarUML — from data models, entities, columns, relationships, indexes, and sequences to PostgreSQL DDL generation.

Architecture

Related MCP server: Supabase MCP

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-erd-mcp.git
cd staruml-controller-erd-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 ERD tools become available via MCP

4. Configure your AI assistant

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

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

Or via CLI:

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

Restart your AI assistant.

Available Tools

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

ERD Tools

The core of this server — full CRUD for every ERD resource plus DDL generation.

Resource	Tools
Data Models	`erd_list_data_models`, `erd_create_data_model`, `erd_get_data_model`, `erd_update_data_model`, `erd_delete_data_model`
Diagrams	`erd_list_diagrams`, `erd_create_diagram`, `erd_get_diagram`, `erd_update_diagram`, `erd_delete_diagram`
Entities	`erd_list_entities`, `erd_create_entity`, `erd_get_entity`, `erd_update_entity`, `erd_delete_entity`
Columns	`erd_list_columns`, `erd_create_column`, `erd_get_column`, `erd_update_column`, `erd_delete_column`
Relationships	`erd_list_relationships`, `erd_create_relationship`, `erd_get_relationship`, `erd_update_relationship`, `erd_delete_relationship`
Indexes	`erd_list_indexes`, `erd_create_index`, `erd_get_index`, `erd_update_index`, `erd_delete_index`
Sequences	`erd_list_sequences`, `erd_create_sequence`, `erd_get_sequence`, `erd_update_sequence`, `erd_delete_sequence`
DDL	`erd_generate_ddl`

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)

Typical Workflow

1. erd_create_data_model        → Create a data model container
2. erd_create_diagram           → Create an ER diagram
3. erd_create_entity (x N)      → Create entities (tables)
4. erd_create_column (x N)      → Add columns to each entity
5. erd_create_relationship      → Define relationships between entities
6. erd_create_index             → Add indexes for performance
7. diagram_export               → Export as PNG/SVG
8. erd_generate_ddl             → Generate PostgreSQL DDL

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

ChrysaiOAuth
com.chrysai.www
Hosted MCP server for AI-driven data ops. Create apps, manage schemas, and CRUD structured data.
Data Platforms Developer Tools App Automation
2
Artificial Wit AIOAuth
com.artificialwit
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
ERP Systems CRM Knowledge & Memory
2
argo-mcp B
io.github.Argo-RPG-Platform
MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2
Games & Gamification Knowledge & Memory
6221
OrgGen AI
ai.orggen
Generate org charts, MCD/ERD data models, and C4 architecture diagrams — pilot OrgGen AI via MCP.
Software Architecture Data Visualization
2

Related MCP Servers

AI Charts
Software Architecture Developer Tools App Automation
tjameswilliams
A
license
Not graded
quality
D
maintenance
An MCP server that enables AI assistants to programmatically create and manage flowcharts, ERDs, and swimlane diagrams. It provides tools for manipulating diagram structures, performing auto-layouts, and exporting to Mermaid or Markdown formats.
Updated 6 months ago (2026-03-15 21:46 UTC)
2 npm
MIT
Supabase MCP
Databases Developer Tools
coleam00
A
license
Not graded
quality
D
maintenance
An MCP server enabling AI assistants to perform CRUD operations on a Supabase database via a standardized interface.
Updated a year ago (2025-03-29 23:21 UTC)
194
MIT
staruml-controller-dfd-mcp
Software Architecture Developer Tools
pontasan
F
license
Not graded
quality
C
maintenance
An MCP server specialized for Data Flow Diagrams, enabling AI assistants to programmatically create and manage DFD elements like external entities, processes, data stores, and data flows in StarUML.
Updated 7 months ago (2026-02-17 02:12 UTC)
-
StarUML Controller MCP Server
Software Architecture Design Tools
pontasan
F
license
Not graded
quality
C
maintenance
An MCP server that enables AI assistants to programmatically create and manage use case diagrams (actors, use cases, subjects, relationships) in StarUML via a REST API.
Updated 7 months ago (2026-02-17 02:12 UTC)
-