Eraser MCP Server
Provides tools for creating, validating, and fixing diagrams on Eraser.io, supporting multiple diagram types including sequence diagrams, flowcharts, cloud architecture diagrams, and entity relationship diagrams with automatic syntax error correction.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Eraser MCP Server create a sequence diagram for user login flow"
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.
Eraser MCP Server
An MCP (Model Context Protocol) server that provides tools for creating diagrams on Eraser.io.
Features
Create diagrams on Eraser.io using their API
Support for multiple diagram types (sequence-diagram, flowchart-diagram, cloud-architecture-diagram, entity-relationship-diagram)
Returns direct links to view and edit diagrams
Validate diagram syntax before creating
Automatically fix common syntax errors
Simple Docker-based integration with Claude Desktop
Related MCP server: Eraser Diagram Renderer
Quick Setup
1. Get an Eraser.io API Key
Sign up at Eraser.io and get your API key from your account settings.
2. Build the Docker Image
Clone this repository and build the Docker image:
git clone <repository-url>
cd eraser-mcp
./scripts/build-claude-docker.sh3. Configure Claude Desktop
Add this configuration to your Claude Desktop settings file:
Configuration File Location:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Configuration:
{
"mcpServers": {
"eraser": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e", "ERASER_API_KEY=yourapikey",
"eraser-mcp:claude"
]
}
}
}4. Restart Claude Desktop
After saving the configuration file, completely quit and restart Claude Desktop.
5. Test the Integration
In Claude Desktop, try asking:
"Create a sequence diagram showing a login process"
"Can you validate this flowchart syntax?"
6. Create a Claude Desktop Project (Optional)
For better organization and persistent access to diagram syntax references, create a dedicated project:
Create a new project in Claude Desktop by clicking the "+" icon in the sidebar
Name your project (e.g., "Eraser Diagrams" or "System Architecture")
Add the syntax guide by uploading or copying the diagram syntax documentation to your project knowledge base
Benefits of using a project:
Persistent access to diagram syntax documentation
Context-aware assistance for diagram creation
Organized workspace for all your architecture diagrams
Custom instructions ensure consistent diagram formatting
Now you can chat with Claude in this project and it will automatically use the Eraser MCP tools with full knowledge of the proper syntax for all diagram types.
Available Tools
create_diagram
Creates a new diagram on Eraser.io and returns links to view and edit it.
Parameters:
content(required): Diagram content in Eraser DSL formatdiagramType(optional): Type of diagram (sequence-diagram, cloud-architecture-diagram, entity-relationship-diagram, flowchart-diagram). Default: sequence-diagramtheme(optional): Theme for the diagram (light, dark). Default: darkbackground(optional): Whether to include background in the rendered image. Default: true
Returns:
Image URL: Direct link to view/download the rendered diagram image
Edit URL: Link to open and edit the diagram in Eraser
validate_diagram
Validates Eraser diagram syntax and returns any errors found.
Parameters:
content(required): Diagram content in Eraser DSL format to validatediagramType(optional): Type of diagram to validate. Default: sequence-diagram
Returns:
Validation result indicating if the diagram syntax is valid
List of errors and warnings found (if any)
fix_diagram
Validates and attempts to fix common syntax errors in Eraser diagrams.
Parameters:
content(required): Diagram content in Eraser DSL format to fixdiagramType(optional): Type of diagram to fix. Default: sequence-diagram
Returns:
List of applied fixes
Fixed diagram content
Validation status after fixes
Examples
Creating a Sequence Diagram
Create a sequence diagram with this content:
Client > Server: Request
Server > Database: Query
Database --> Server: Results
Server --> Client: ResponseCreating a Flowchart
Create a flowchart:
Start [shape: oval]
Start > Process
Process > Decision [shape: diamond]
Decision > End [shape: oval]Validation Features
The server includes built-in validation for all supported diagram types:
Sequence Diagrams: Validates message formats, activation blocks, and control structures
Flowcharts: Validates node definitions, connections, shapes, and groups
Entity Relationship Diagrams: Validates entity definitions, attributes, and relationships
Cloud Architecture Diagrams: Validates service definitions, icons, and connections
Common fixes applied automatically:
Arrow syntax corrections (e.g.,
=>to>)Missing brackets and quotes
Trailing whitespace removal
Missing colons in sequence messages
Shape name corrections (e.g.,
circletooval)
Troubleshooting
Docker Image Not Found
Error: Unable to find image 'eraser-mcp:claude'
Solution: Run the build script: ./scripts/build-claude-docker.sh
API Key Issues
Error: Server reports API key errors
Solution: Check that your API key is correct in the configuration
Permission Issues
Error: Docker permission denied
Solution: Ensure Docker is running and your user has Docker permissions
Development
For development, you can use the included Dev Container:
Open in VS Code with Dev Containers extension
Make changes to the code
Rebuild the Docker image:
./scripts/build-claude-docker.sh
Development Commands
npm install- Install dependenciesnpm run dev- Run with hot reloadnpm run build- Build TypeScript to JavaScriptnpm run lint- Run ESLintnpm run typecheck- Run TypeScript type checking
Testing
cd tests
./run-tests.shDiagram Syntax Documentation
For detailed syntax information for each diagram type, visit:
License
MIT
Available Tools
3 toolscreate_diagramA
Inputs: content (required), diagramType, theme, background.
fix_diagramA
Inputs: content (required), diagramType.
validate_diagramA
Inputs: content (required), diagramType.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools have clearly distinct purposes with no overlap: validate_diagram checks syntax, fix_diagram corrects errors, and create_diagram renders final diagrams. The detailed when-to-use/when-not-to-use sections explicitly differentiate them, and the workflow-position tags reinforce their sequential relationship (validate→fix→create).
All tool names follow a consistent verb_noun pattern (validate_diagram, fix_diagram, create_diagram) with the same noun ('diagram') and clear action verbs. This uniformity makes the tool set predictable and easy to understand at a glance.
Three tools is perfectly appropriate for this server's focused domain of diagram processing. Each tool serves a distinct, essential function in the workflow (validation, correction, creation), and there are no missing or extraneous tools—the count aligns well with the scope.
The tool set provides complete coverage for the diagram lifecycle: validation, fixing, and creation. There are no gaps; agents can handle any diagram-related request from syntax checking to final rendering, with clear guidance on tool selection through the detailed documentation.
Maintenance
Related MCP Connectors
Generate, edit, and manage Eraser diagrams and docs with AI.
Generate cloud architecture diagrams, flowcharts, and sequence diagrams.
Create workflow, sequence, architecture, and mind map diagrams via AI assistants.
Make editable flowcharts, process charts, funnels, timelines and data models from plain language.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables generation of PlantUML diagrams (sequence, class, C4, architecture) with embeddable SVG/PNG URLs, encoding/decoding capabilities, and automatic syntax error detection and fixing.31,028 npm55MIT
- AlicenseNot gradedqualityDmaintenanceEnables rendering of diagrams (sequence, flowchart, ER, cloud architecture, etc.) using the Eraser.io API with customizable themes, backgrounds, and scaling options. Returns image URLs or base64-encoded content with built-in icon validation.23MIT
- FlicenseNot gradedqualityDmaintenanceEnables the dynamic generation of various software development diagrams, such as flowcharts, sequence diagrams, and architecture diagrams, using Mermaid syntax. It includes tools for diagram validation and provides instructions for exporting results to multiple formats including SVG and PNG.-
- AlicenseNot gradedqualityDmaintenanceEnables creating and editing Draw.io diagrams via natural language, supporting shapes, connectors, and multi-line text.2MIT