Server data from the Official MCP Registry
Generate software diagrams from natural language, code, ASCII, images, Mermaid.
Generate software diagrams from natural language, code, ASCII, images, Mermaid.
Valid MCP server (4 strong, 2 medium validity signals). 2 known CVEs in dependencies (0 critical, 2 high severity) Package registry verified. Imported from the Official MCP Registry.
7 files analyzed Β· 3 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: YOUR_API_KEY
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-erajasekar-ai-diagram-maker-mcp": {
"env": {
"YOUR_API_KEY": "your-your-api-key-here"
},
"args": [
"-y",
"ai-diagram-maker-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
MCP server for AI Diagram Maker β generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent.
The public MCP endpoint is https://mcp.aidiagrammaker.com/mcp (Streamable HTTP). Nothing to install for this option.
For remote HTTP clients, send your API key on every request β not via environment variables:
X-ADM-API-Key: <your_api_key> (recommended), orAuthorization: Bearer <your_api_key>Use the API key from your AI Diagram Maker account (see Prerequisites).
Merge this into your clientβs MCP config (replace the API key placeholder):
{
"mcpServers": {
"ai-diagram-maker": {
"url": "https://mcp.aidiagrammaker.com/mcp",
"headers": {
"X-ADM-API-Key": "YOUR_API_KEY"
}
}
}
}
Use the remote server JSON example above and wire it into your client using MCP client configuration. No global install.
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).
ADM_API_KEY=your_api_key npx ai-diagram-maker-mcp@latest
Add to ~/.cursor/mcp.json or Settings β MCP using the remote server JSON example. No environment variables are required for this setup.
{
"mcpServers": {
"ai-diagram-maker": {
"command": "npx",
"args": ["-y", "ai-diagram-maker-mcp@latest"],
"env": {
"ADM_API_KEY": "your_api_key_here"
}
}
}
}
Optional: add "ADM_DEBUG": "1" to env for debug logging β see Environment variables.
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"ai-diagram-maker": {
"command": "npx",
"args": ["-y", "ai-diagram-maker-mcp@latest"],
"env": {
"ADM_API_KEY": "your_api_key_here"
}
}
}
}
claude mcp add ai-diagram-maker -t stdio -e ADM_API_KEY=<api_key> -- npx -y ai-diagram-maker-mcp@latest
claude mcp add ai-diagram-maker \
--command "npx" \
--args "-y,ai-diagram-maker-mcp@latest" \
--env ADM_API_KEY=your_api_key_here
To run an HTTP server yourself (same header-based auth as Authentication (HTTP)):
npx ai-diagram-maker-mcp@latest --transport http
The server listens on $PORT or 3001. Point clients at /mcp and send the API key with each request using the headers above.
| 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. |
generate_diagram_from_textGenerate a diagram from a natural language description.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | Yes | Natural language description of the diagram |
diagramType | enum | No | flowchart, sequence, erd, system_architecture, uml |
prompt | string | No | Additional styling/layout instruction |
Example prompts:
generate_diagram_from_jsonConvert a JSON structure into a diagram (great for API responses, database schemas, config files).
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | Yes | JSON string to visualise |
prompt | string | No | How to interpret the JSON |
diagramType | enum | No | Preferred diagram type |
generate_diagram_from_asciiConvert ASCII art into a polished diagram.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | Yes | Raw ASCII art diagram |
prompt | string | No | Rendering instructions |
diagramType | enum | No | Preferred diagram type |
generate_diagram_from_imageConvert a whiteboard photo, screenshot, or any image into a clean diagram.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | Yes | Public image URL or base64 data URI |
prompt | string | No | What to extract or how to render |
diagramType | enum | No | Preferred output diagram type |
generate_diagram_from_mermaidConvert a Mermaid diagram definition to D2 and return a PNG image.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | Yes | Mermaid diagram source (e.g. flowchart, sequenceDiagram, erDiagram) |
prompt | string | No | Optional layout or styling instruction |
diagramType | enum | No | Preferred diagram type for the converted output |
The AI agent will automatically select the right tool when you use phrases like:
adm ...ai diagram maker ...create a diagram of ...show me a flowchart / sequence diagram / ERD / architecture ...visualise / draw / diagram ...Use these steps to clone the repo, build locally, and run the MCP server with Node.
git clone https://github.com/erajasekar/ai-diagram-maker-mcp.git
cd ai-diagram-maker-mcp
npm install
If you change the AI Diagram Maker OpenAPI spec or config, regenerate the client:
npm run generate
npm run build
This compiles TypeScript and builds the MCP app UI into dist/. The server entrypoint is dist/index.js.
stdio (default) β for use with Cursor, Claude Desktop, etc.:
ADM_API_KEY=your_api_key node dist/index.js
Or use the npm script:
ADM_API_KEY=your_api_key npm start
HTTP transport β for remote clients or testing (same headers as Authentication (HTTP)):
ADM_API_KEY=your_api_key node dist/index.js --transport http
Or:
ADM_API_KEY=your_api_key npm run start:http
The HTTP server listens on $PORT (default 3001).
Point Cursor at your built server via Settings β MCP (or ~/.cursor/mcp.json):
{
"mcpServers": {
"ai-diagram-maker": {
"command": "node",
"args": ["/absolute/path/to/ai-diagram-maker-mcp/dist/index.js"],
"env": {
"ADM_API_KEY": "your_api_key_here"
}
}
}
}
Replace /absolute/path/to/ai-diagram-maker-mcp with the actual path to your cloned repo. After changing the config, restart Cursor or reload the MCP servers.
For debug logging, add "ADM_DEBUG": "1" to env β see Environment variables.
MIT
Be the first to review this server!
by Modelcontextprotocol Β· Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno Β· Developer Tools
Toleno Network MCP Server β Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace Β· Developer Tools
Create, build, and publish Python MCP servers to PyPI β conversationally.