erajasekar/ai-diagram-maker-mcp

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent.
- ai-diagram-maker-mcp 🌐 ☁️ - Generate professional software diagrams from plain English descriptions.
Features
- **5 tools** covering every input type: natural language text, code, ASCII diagram, images, and Mermaid
- **Inline rendering** — diagrams appear directly in the chat using MCP Apps UI, no downloads
- **Diagram URL in responses** — open it in your browser to view and edit the diagram
- **5 diagram types**: flowchart, sequence, ERD, system architecture, UML
- Supports both **stdio** (local) and **HTTP/Streamable HTTP** (remote) transports
Contents
- Prerequisites
- Hosted MCP server
- Installation
- MCP client configuration
- Environment variables
- Tools
- Trigger keywords
- Local developer setup
- License
Prerequisites
1. Node.js 18+
2. An AI Diagram Maker account and API key
Hosted MCP server
The public MCP endpoint is **https://mcp.aidiagrammaker.com/mcp** (Streamable HTTP). Nothing to install for this option.
Authentication (HTTP)
For remote HTTP clients, send your API key on every request — **not** via environment variables:
- X-ADM-API-Key: (recommended), or
- Authorization: Bearer
Use the API key from your AI Diagram Maker account (see Prerequisites).
Remote server JSON example
Merge this into your client’s MCP config (replace the API key placeholder):
Installation
Option A — hosted server (recommended)
Use the remote server JSON example above and wire it into your client using MCP client configuration. No global install.
Option B — run locally with npx
Nothing to install permanently — npx runs the package on demand. The package name is ai-diagram-maker-mcp; append @latest if you want every invocation to resolve the newest release (recommended for one-off runs and claude mcp add).
MCP client configuration
Cursor
Remote (recommended)
Add to ~/.cursor/mcp.json or **Settings → MCP** using the remote server JSON example. No environment variables are required for this setup.
Local (stdio)
Optional: add "ADM_DEBUG": "1" to env for debug logging — see Environment variables.
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Claude Code
macOS
Windows
HTTP transport (local or self-hosted)
To run an HTTP server yourself (same header-based auth as Authentication (HTTP)):
The server listens on $PORT or **3001**. Point clients at /mcp and send the API key with each request using the headers above.
Environment variables
| Variable | Required | Default | Description |
|---|---|---|---|
| ADM_API_KEY | Yes (stdio only) | — | Your AI Diagram Maker API key (stdio transport only; remote HTTP clients use headers — see Authentication (HTTP)) |
| ADM_BASE_URL | No | https://app.aidiagrammaker.com | Override for local/staging API; also used as the base for diagram URLs in tool responses |
| ADM_DEBUG | No | — | Set to 1, true, or yes to log request parameters from the AI agent and the payload sent to the AI Diagram Maker API. Logs go to **stderr**. In **Cursor**, open **Output**, choose the **MCP** or **ai-diagram-maker** channel to read the server logs. |
Tools
generate_diagram_from_text