AI Diagram Maker MCP Server

AI制图器MCP服务器

MCP服务器 AI图表制作工具 --直接在Cursor、Claude Desktop、Claude Code或任何兼容MCP的AI代理中生成漂亮的软件工程图。

特性

• 5工具 涵盖所有输入类型：自然语言文本、代码、ASCII图、图像和Mermaid
• 内联渲染 --图表直接出现在使用MCP Apps UI的聊天中，无需下载
• 响应中的图表URL --在浏览器中打开它以查看和编辑图表
• 5种图表类型：流程图、序列、ERD、系统架构、UML
• 支持两者 标准 （当地）和 HTTP/可流式传输HTTP （远程）运输

目录

• 先决条件
• 托管MCP服务器
• 安装
• MCP客户端配置
• 环境变量
• 工具
• 触发器关键字
• 本地开发人员设置
• 许可证

先决条件

1. Node.js 18+
2. 一 AI图表制作工具 帐户和API密钥

托管MCP服务器

公共MCP端点为 https://mcp.aidiagrammaker.com/mcp （流式HTTP）。此选项无需安装任何内容。

身份验证（HTTP）

对于远程HTTP客户端，请在每次请求时发送API密钥- 不 通过环境变量：

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

使用您的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；附加 @latest 如果您希望每次调用都解析最新版本（建议用于一次性运行和 claude mcp add).

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

MCP客户端配置

光标

远程（推荐）

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

本地（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 有关调试日志记录，请参阅 环境变量.

克劳德桌面

添加 ~/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"
      }
    }
  }
}

克劳德代码

macOS

claude mcp add ai-diagram-maker -t stdio -e ADM_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

HTTP传输（本地或自托管）

自己运行HTTP服务器（与基于标头的身份验证相同 身份验证（HTTP）):

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

服务器正在监听 $PORT 或 3001.将客户指向 /mcp 并且使用上面的报头将API密钥与每个请求一起发送。

环境变量

工具

generate_diagram_from_text

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

示例提示：

• *用API网关、身份验证服务、用户服务和PostgreSQL数据库创建微服务架构*
• *“使用JWT令牌生成绘制用户登录流程的序列图”*
• *“adm显示部署到Vercel的Next.js应用程序的CI/CD管道”*

______________________________________________________________________

generate_diagram_from_json

将JSON结构转换为图表（非常适合API响应、数据库模式、配置文件）。

______________________________________________________________________

generate_diagram_from_ascii

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

______________________________________________________________________

generate_diagram_from_image

将白板照片、屏幕截图或任何图像转换为干净的图表。

______________________________________________________________________

generate_diagram_from_mermaid

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

触发器关键字

当您使用以下短语时，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):

{
  "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 --看 环境变量.

许可证

麻省理工学院