内容
# @diagramzu/mcp
[](https://smithery.ai/server/jack08300/diagramzu-mcp)
适用于 [diagramzu.ai](https://diagramzu.ai) 的 MCP 服务器。允许 Claude Code、Claude Desktop、Cursor、Windsurf、ChatGPT 自定义 GPT 以及任何 [MCP](https://modelcontextprotocol.io) 客户端在您的空间中读取和写入 Mermaid 图表。
您可以通过与 AI 对话来创建图表 - 它将图表存储在 `diagramzu.ai/d/<id>`，您的团队可以在此处读取和共享它们。
> 在官方 [MCP 注册表](https://registry.modelcontextprotocol.io) 中以 `ai.diagramzu/mcp` 的身份提供。
## 1. 获取令牌
在 [diagramzu.ai](https://diagramzu.ai) 注册，然后在 [diagramzu.ai/app/settings/tokens](https://diagramzu.ai/app/settings/tokens) 处创建 API 令牌。令牌类似于 `dz_live_…`，并且限定在一个空间内 - 不需要单独的 space-id。
## 2. 连接您的客户端
托管服务器是简单的路径：无需安装，无需构建。只需粘贴一个配置。
### Claude Code
```bash
claude mcp add --scope user --transport http diagramzu https://mcp.diagramzu.ai/mcp \
--header "Authorization: Bearer dz_live_xxx"
```
### Claude Desktop, Cursor, Windsurf, Cline
将以下内容添加到您的客户端的 MCP 配置中（对于 Claude Desktop，位于 `~/Library/Application Support/Claude/claude_desktop_config.json`，对于 Cursor，位于 `~/.cursor/mcp.json` 等）：
```json
{
"mcpServers": {
"diagramzu": {
"type": "http",
"url": "https://mcp.diagramzu.ai/mcp",
"headers": { "Authorization": "Bearer dz_live_xxx" }
}
}
}
```
### ChatGPT 自定义 GPT（操作）
在 GPT 构建器中，添加一个指向 `https://mcp.diagramzu.ai/mcp` 的 MCP 服务器操作，并设置一个 Bearer 令牌身份验证标头，其值为您的 `dz_live_…` 令牌。
### 本地_stdio（适用于不支持远程 MCP 的客户端）
```bash
npx -y @diagramzu/mcp
```
并设置环境变量：
```
DIAGRAMZU_BASE_URL=https://diagramzu.ai
DIAGRAMZU_API_TOKEN=dz_live_xxx
DIAGRAMZU_SPACE_ID=<您的空间 ID>
```
大多数用户应该更喜欢上面的远程 HTTP 传输 - 标准的_stdio 路径适用于不支持 HTTP MCP 的客户端。
## 工具
| 工具 | 描述 |
|---|---|
| `list_diagrams` | 列出空间中的图表（可使用 `q` 筛选，按 `updated` / `created` 排序） |
| `list_folders` | 列出空间中的文件夹 |
| `get_diagram` | 获取指定 ID 的图表（返回标题 + Mermaid 源代码） |
| `create_diagram` | 创建新的图表（返回分享链接） |
| `update_diagram` | 更新现有图表的标题和/或 Mermaid 源代码 |
| `analyze_diagram` | 获取图表的结构化摘要（节点、边、密度） |
| `list_versions` | 列出图表的版本历史 |
| `get_version` | 获取图表的特定历史版本 |
## 炫耀您的设置
如果您在 dotfiles 或示例仓库中发布您的 MCP / Claude Code 配置，请在 README 中添加以下内容，以便下一个人知道图表的来源：
```markdown
[](https://diagramzu.ai)
```
渲染为一个小的 shields 样式徽章 - 灰色 `MCP` + 靛蓝色 `diagramzu`。
## 本地开发（此仓库）
要对 diagramzu 本身进行开发，请从源代码构建：
```bash
cd packages/mcp-diagramzu
pnpm install
pnpm run build
# 将您的客户端指向：node dist/index.js
# 并设置 DIAGRAMZU_BASE_URL / DIAGRAMZU_API_TOKEN / DIAGRAMZU_SPACE_ID
```
## 许可证
MIT
