d2-mcp

用于 D2 图表语言 的 MCP 服务器。从任何兼容 MCP 的 AI 助手编译、验证和探索 D2 图表。

使用原生 D2 CLI 二进制文件（在 Docker 镜像中自动安装）将图表编译为 SVG 和 PNG。

工具

资源

本地开发

先决条件

• Node.js 22+

• D2 CLI — 从 d2lang.com 安装，或将 D2_PATH 环境变量设置为二进制文件路径。

• 图标（可选） — 运行 scripts/download-icons.sh ./icons 然后设置 ICONS_DIR=./icons 以启用本地图标解析。如果不这样做，图标 URL 将按原样传递给 D2 CLI。

npm install
npm run build
npm start

用于自动重载的开发：

npm run dev

服务器默认在 3000 端口启动（可通过 PORT 环境变量覆盖）。

• 健康检查：GET /health

• MCP 端点：POST /mcp（可流式传输的 HTTP 传输）

环境变量

部署 (Render)

本项目包含一个 Dockerfile 和 render.yaml 蓝图，可一键部署到 Render。Docker 镜像会在构建时自动安装 D2 CLI 二进制文件并下载所有图标。

1. 将此仓库推送到 GitHub

2. 在 Render 中，创建一个新的 Blueprint 并连接您的仓库

3. Render 将自动检测 render.yaml 并进行部署

或者手动创建一个 Web Service：

• 环境： Docker

• 健康检查路径： /health

• 计划： 免费

连接到 MCP 服务器

部署完成后，配置您的 MCP 客户端以通过可流式传输的 HTTP 进行连接：

{
  "mcpServers": {
    "d2": {
      "url": "https://your-service.onrender.com/mcp"
    }
  }
}

将 URL 替换为您实际的 Render 服务 URL（或本地的 http://localhost:3000/mcp）。

编译工具选项

许可证

MIT