AI Diagram Maker MCP Server

官方

AI Diagram Maker 的 MCP 服务器 — 直接在 Cursor、Claude Desktop、Claude Code 或任何兼容 MCP 的 AI 代理中生成精美的软件工程图表

GitHub

文档

AI Diagram Maker MCP 服务器

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

ai-diagram-maker-mcp 🌐 ☁️ - 通过简单的英文描述生成专业的软件图表。

功能特性

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

前提条件

Node.js 18+
一个 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

远程（推荐）

使用远程服务器 JSON 示例添加到 ~/.cursor/mcp.json 或 设置 → MCP。此设置无需环境变量。

本地（stdio）

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

可选：将 "ADM_DEBUG": "1" 添加到 env 以进行调试日志记录——请参阅环境变量。

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 代理的请求参数以及发送到 AI Diagram Maker API 的有效负载。日志输出到 stderr。在 Cursor 中，打开输出，选择 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 代理将自动选择合适的工具：

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 中使用本地服务器

通过 设置 → 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 服务器。

对于调试日志记录，将 "ADM_DEBUG": "1" 添加到 env——请参阅环境变量。

许可证

MIT