Ai Diagram Maker Mcp Server

AI Diagram Maker MCP 服务

适用于 AI Diagram Maker 的 MCP 服务——可直接在 Cursor、Claude Desktop、Claude Code 或任何兼容 MCP 的 AI Agent 中生成精美的软件工程图表。

• ai-diagram-maker-mcp 🌐 ☁️ - 根据自然语言描述生成专业的软件图表。

功能

• 5 个工具，覆盖各种输入类型：自然语言文本、代码、ASCII 图表、图像和 Mermaid
• 内嵌渲染——图表通过 MCP Apps UI 直接显示在聊天中，无需下载
• 在响应中提供图表 URL——在浏览器中打开即可查看和编辑图表
• 5 种图表类型：流程图、时序图、ERD、系统架构图、UML
• 支持 stdio（本地）和 HTTP/Streamable HTTP（远程）两种传输方式

目录

• 前提条件
• 托管 MCP 服务
• 安装
• MCP 客户端配置
• 环境变量
• 工具
• 触发关键词
• 本地开发环境设置
• 许可证

前提条件

1. Node.js 18+
2. AI Diagram Maker 账户和 API 密钥

托管 MCP 服务

公共 MCP 端点为 **https://mcp.aidiagrammaker.com/mcp**（Streamable HTTP）。使用此选项无需安装。

身份验证（HTTP）

对于远程 HTTP 客户端，每次请求都需发送 API 密钥——不要通过环境变量发送：

• X-ADM-API-Key: <your_api_key>（推荐），或
• Authorization: Bearer <your_api_key>

使用 AI Diagram Maker 账户中的 API 密钥（参见前提条件）。

远程服务 JSON 示例

将此内容合并到客户端的 MCP 配置中（替换 API 密钥占位符）：

{
  "mcpServers": {
    "ai-diagram-maker": {
      "url": "https://mcp.aidiagrammaker.com/mcp",
      "headers": {
        "X-ADM-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

安装

选项 A — 托管服务（推荐）

使用上面的远程服务 JSON 示例，并通过 MCP 客户端配置将其添加到客户端。无需全局安装。

选项 B — 使用 npx 本地运行

无需永久安装——npx 会按需运行此软件包。软件包名称为 ai-diagram-maker-mcp；如果希望每次运行都使用最新版本（推荐用于一次性运行和 claude mcp add），请在后面加上 @latest。

ADM_API_KEY=your_api_key npx ai-diagram-maker-mcp@latest

MCP 客户端配置

Cursor

远程（推荐）

将内容添加到 ~/.cursor/mcp.json，或通过远程服务 JSON 示例在 Settings → MCP 中配置。此设置无需环境变量。

本地（stdio）

{
  "mcpServers": {
    "ai-diagram-maker": {
      "command": "npx",
      "args": ["-y", "ai-diagram-maker-mcp@latest"],
      "env": {
        "ADM_API_KEY": "your_api_key_here"
      }
    }
  }
}

可选：在 env 中添加 "ADM_DEBUG": "1" 以启用调试日志——请参阅环境变量。

Claude Desktop

将内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %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 Code

macOS

claude mcp add ai-diagram-maker -t stdio -e ADM_API_KEY=<api_key> -- npx -y ai-diagram-maker-mcp@latest

Windows

claude mcp add ai-diagram-maker \
  --command "npx" \
  --args "-y,ai-diagram-maker-mcp@latest" \
  --env ADM_API_KEY=your_api_key_here

HTTP 传输（本地或可自托管）

如需自行运行 HTTP 服务（使用与身份验证（HTTP）相同的基于请求头的身份验证方式）：

npx ai-diagram-maker-mcp@latest --transport http

服务会监听 $PORT，若未设置则使用 3001。将客户端指向 /mcp，并按照上文所述在每次请求中通过请求头发送 API 密钥。

环境变量

变量	必需	默认值	描述
ADM_API_KEY	是（仅 stdio）	—	你的 AI Diagram Maker API 密钥（仅限 stdio 传输；远程 HTTP 客户端使用请求头——参见身份验证（HTTP））
ADM_BASE_URL	否	https://app.aidiagrammaker.com	本地或预发布 API 的覆盖地址；也用作工具响应中图表 URL 的基址
ADM_DEBUG	否	—	设置为 1、true 或 yes，以记录 AI Agent 的请求参数以及发送到 AI Diagram Maker API 的负载。日志会输出到 stderr。在 Cursor 中，打开 Output，选择 MCP 或 ai-diagram-maker 通道以查看服务日志。

工具

generate_diagram_from_text

根据自然语言描述生成图表。

参数	类型	必需	描述
content	string	是	图表的自然语言描述
diagramType	enum	否	flowchart、sequence、erd、system_architecture、uml
prompt	string	否	额外的样式或布局指令

提示词示例：

• “创建一个微服务架构，包含 API 网关、身份验证服务、用户服务和 PostgreSQL 数据库”
• “绘制一个用户登录流程的时序图，包含 JWT 令牌生成”
• “adm 展示部署到 Vercel 的 Next.js 应用的 CI/CD 流水线”

---

generate_diagram_from_json

将 JSON 结构转换为图表（非常适用于 API 响应、数据库架构和配置文件）。

参数	类型	必需	描述
content	string	是	要可视化的 JSON 字符串
prompt	string	否	如何解读 JSON
diagramType	enum	否	首选图表类型

---

generate_diagram_from_ascii

将 ASCII 艺术图转换为精美图表。

参数	类型	必需	描述
content	string	是	原始 ASCII 艺术图
prompt	string	否	渲染指令
diagramType	enum	否	首选图表类型

---

generate_diagram_from_image

将白板照片、屏幕截图或任意图像转换为清晰的图表。

参数	类型	必需	描述
content	string	是	公开图像 URL 或 base64 数据 URI
prompt	string	否	要提取的内容或渲染方式
diagramType	enum	否	首选输出图表类型

---

generate_diagram_from_mermaid

将 Mermaid 图表定义转换为 D2 并返回 PNG 图像。

参数	类型	必需	描述
content	string	是	Mermaid 图表源代码（例如 flowchart、sequenceDiagram、erDiagram）
prompt	string	否	可选的布局或样式指令
diagramType	enum	否	转换后输出的首选图表类型

触发关键词

使用以下短语时，AI Agent 会自动选择合适的工具：

• adm ...
• ai diagram maker ...
• create a diagram of ...
• show me a flowchart / sequence diagram / ERD / architecture ...
• visualise / draw / diagram ...

本地开发者设置

按照以下步骤克隆仓库、本地构建并使用 Node 运行 MCP 服务。

1. 克隆仓库

git clone https://github.com/erajasekar/ai-diagram-maker-mcp.git
cd ai-diagram-maker-mcp

2. 安装依赖

npm install

3. （可选）重新生成 API 客户端

如果更改了 AI Diagram Maker OpenAPI 规范或配置，请重新生成客户端：

npm run generate

4. 构建

npm run build

此操作会编译 TypeScript，并将 MCP 应用 UI 构建到 dist/。服务入口文件为 dist/index.js。

5. 运行本地 MCP 服务

stdio（默认）——用于 Cursor、Claude Desktop 等：

ADM_API_KEY=your_api_key node dist/index.js

或者使用 npm 脚本：

ADM_API_KEY=your_api_key npm start

HTTP 传输——用于远程客户端或测试（请求头与身份验证（HTTP）相同）：

ADM_API_KEY=your_api_key node dist/index.js --transport http

或者：

ADM_API_KEY=your_api_key npm run start:http

HTTP 服务在 $PORT 上监听（默认值为 3001）。

6. 在 Cursor 中使用本地服务

通过 Settings → MCP（或 ~/.cursor/mcp.json）将 Cursor 指向构建好的服务：

{
  "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"
      }
    }
  }
}

将 /absolute/path/to/ai-diagram-maker-mcp 替换为克隆仓库的实际路径。更改配置后，重启 Cursor 或重新加载 MCP 服务。

如需启用调试日志，请在 env 中添加 "ADM_DEBUG": "1"，参见环境变量。

许可证

MIT