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 "Install 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 Related Servers Score Discussions

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 installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

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-erd-mcp'

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