AI图表生成器

AI Diagram Maker MCP服务器是一个用于生成软件工程图表的工具,支持通过自然语言描述、代码、ASCII图、图片和Mermaid等多种输入方式创建流程图、序列图、ERD、系统架构图和UML图等。

  • by erajasekar
  • TypeScript
  • 混合部署
  • 10 星标
  • 更新于
在 GitHub 查看 erajasekar/ai-diagram-maker-mcp

使用说明

AI制图器MCP服务器

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

  • ai图生成器mcp 🌐 ☁️ - 从简单的英文描述中生成专业软件图。

特性

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

目录

先决条件

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

托管MCP服务器

公共MCP端点为 https://mcp.aidiagrammaker.com/mcp (流式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;附加 @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=<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密钥与每个请求一起发送。

环境变量

变量 必填 默认 描述
ADM_API_KEY 是(仅限stdio) - 您的AI Diagram Maker API密钥(仅限tdio传输;远程HTTP客户端使用标头-请参阅 身份验证(HTTP))
ADM_BASE_URL 没有 https://app.aidiagrammaker.com 本地/分段API的覆盖;也用作工具响应中图表URL的基础
ADM_DEBUG 否 -- 设置为 1, true,或 yes 以记录来自AI代理的请求参数和发送到AI图生成器API的有效载荷。日志转到 标准错误.In 光标,打开 输出,选择 主控程序 或 ai图生成器 用于读取服务器日志的通道。

工具

generate_diagram_from_text

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

参数 类型 必填 说明
content string 是 图表的自然语言描述
diagramType enum 否 流程图、序列、erd、系统架构、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 是 美人鱼图源(例如流程图、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):

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

许可证

麻省理工学院