Eraser Diagram Renderer

v1.0.0Developer Toolsstable

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

code-to-diagramdiagramdiagram-generationdiagrammingdiagramming-as-code
Share:
21
Stars
0
Downloads
0
Weekly
0/5

What is Eraser Diagram Renderer?

Eraser Diagram Renderer is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables 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-encod...

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

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables rendering of diagrams (sequence, flowchart, ER, clou

Use Cases

Render sequence diagrams, flowcharts, and ER diagrams using Eraser.io.
Generate architecture diagrams from code with customizable themes.
buck-0x

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMar 29, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx eraser-diagram-renderer

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Eraser Diagram Renderer

Eraser Diagram Renderer is a Python MCP server and CLI tool that renders diagrams using the Eraser.io API, supporting sequence diagrams, flowcharts, entity-relationship diagrams, cloud architecture diagrams, and more. It accepts diagram code written in Eraser's diagram-as-code DSL and returns either a hosted image URL (with a link to edit the diagram in Eraser) or base64-encoded image content. It also validates icon references against the standard Eraser icon list and supports customizable themes (light/dark), background options, and scale factors.

Prerequisites

  • Python 3.10 or higher installed
  • An Eraser.io API token (sign up at eraser.io to obtain one)
  • uv or pip for installing the package
  • An MCP-compatible client such as Claude Desktop, VS Code, or Windsurf
1

Obtain an Eraser.io API token

Sign up or log in at eraser.io. Navigate to your account settings to generate an API token. You will set this as the ERASER_API_TOKEN environment variable.

2

Clone and install the MCP server

Clone the repository and install it locally with pip or uv. The package is not on PyPI, so you install it from source in editable mode.

git clone https://github.com/buck-0x/eraser-io-mcp-server.git
cd eraser-io-mcp-server
pip install -e .
# or with uv:
uv pip install -e .
3

Set the API token environment variable

Export your Eraser API token so the server and CLI can authenticate with the Eraser API.

export ERASER_API_TOKEN=your_token_here
4

Test with the CLI

Run a quick CLI test to make sure the token and API are working before connecting an MCP client.

python render_eraser_diagram.py --diagram-type sequence-diagram --code "Alice -> Bob: Hello"
5

Configure your MCP client

Add the server to your MCP client configuration, passing the API token as an environment variable. Point to main.py in the cloned directory.

Eraser Diagram Renderer Examples

Client configuration

Add this to your MCP client config. Update the path to match where you cloned the repository.

{
  "mcpServers": {
    "eraser-diagram-renderer": {
      "command": "python",
      "args": ["/path/to/eraser-io-mcp-server/main.py"],
      "env": {
        "ERASER_API_TOKEN": "your_eraser_api_token_here"
      }
    }
  }
}

Prompts to try

Ask your AI assistant to generate architecture and flow diagrams using Eraser's diagram-as-code syntax.

- "Draw a sequence diagram showing how a user logs in: browser sends credentials to API, API checks the database, returns a JWT token."
- "Create a cloud architecture diagram for an AWS deployment with an S3 bucket, Lambda function, and API Gateway."
- "Generate an ER diagram for a blog with users, posts, and comments tables."
- "Render a flowchart showing the checkout process in an e-commerce app with light theme."
- "Create a sequence diagram for a microservices order flow and return the image URL."

Troubleshooting Eraser Diagram Renderer

API returns 401 Unauthorized

Your ERASER_API_TOKEN is missing or incorrect. Verify the token is exported in the environment or set in the env block of your MCP config. Generate a new token in your Eraser.io account settings if needed.

Icon validation warnings appear in the response

The server checks icon names against a standard list. If you use custom or non-standard icon names in your diagram code, you will see a warning but the diagram still renders. Set SKIP_ICON_CHECK=true in your environment to suppress the warnings.

Diagram image does not update after changing theme or background

This is a known Eraser API caching limitation: the image cache is only invalidated when the diagram code changes. To force a new render, make a minor edit to the diagram code itself (e.g., add a comment or a space).

Frequently Asked Questions about Eraser Diagram Renderer

What is Eraser Diagram Renderer?

Eraser Diagram Renderer is a Model Context Protocol (MCP) server that enables 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. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Eraser Diagram Renderer?

Follow the installation instructions on the Eraser Diagram Renderer GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Eraser Diagram Renderer?

Eraser Diagram Renderer works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Eraser Diagram Renderer free to use?

Yes, Eraser Diagram Renderer is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "eraser-diagram-renderer": { "command": "npx", "args": ["-y", "eraser-diagram-renderer"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Eraser Diagram Renderer?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides