AI 集成（MCP 服务器）

Diagrammix 内置了 MCP（模型上下文协议）服务器，让 Claude、Codex 等 AI 助手可以直接读取和修改你的图表。用自然语言描述你的需求，AI 就会在画布上为你放置符号、连接器和布局。

AI 能做什么？

根据描述创建图表 — 请求一个流程图、网络拓扑图或组织结构图，即可立即在画布上生成
构建思维导图 — 描述一个主题，即可获得结构化的思维导图
读取你的文档 — AI 能看到你当前的形状、连接器、图层和样式
修改现有元素 — 更新文本、颜色、位置或连接器路由
批量操作 — 一步创建包含符号和连接器的完整图表
自动布局与对齐 — 用自然语言指令组织元素
复刻图片中的外观 — 将参考图片交给 AI，它会构建出与之匹配的自定义模板和样式
导出 — 按需生成 SVG、PNG、Visio（.vsdx）或 Mermaid 输出

前提条件

Diagrammix PRO（一次性购买）
Diagrammix 必须处于运行状态，并已启用 MCP 服务器
如果没有打开的文档，助手可以创建一个新文档
AI 客户端和 Diagrammix 必须在同一台机器上（localhost）

无需 Node.js、npx 或 mcp-remote——Diagrammix 为需要它的客户端内置了原生辅助程序。

设置

1. 启用 MCP 服务器

打开 Diagrammix
依次选择 Diagrammix > 设置（或按 Cmd+,）
切换到 AI 集成 标签页
在 MCP 服务器 部分，打开 启用 MCP 服务器

服务器启动后，状态会显示 运行中。服务器监听地址为 http://localhost:8420/mcp。

2. 配置 Claude Desktop

Claude Desktop 通过 stdio 连接。Diagrammix 在应用包内提供了 原生 stdio 辅助程序，因此 无需 Node.js、npx 或 mcp-remote。

在 Diagrammix 设置中点击 复制配置——这会填入指向你安装的应用中内置辅助程序的确切路径
打开 Claude Desktop 配置文件： ~/Library/Application Support/Claude/claude_desktop_config.json
粘贴该配置。它看起来是这样的——其中 command 路径指向 Diagrammix.app 安装位置内的辅助程序：

{
  "mcpServers": {
    "diagrammix": {
      "command": "/Applications/Diagrammix.app/Contents/MacOS/diagrammix-mcp-stdio",
      "args": ["--url", "http://localhost:8420/mcp"]
    }
  }
}

注意： 使用 复制配置 而不是手动输入路径——它会指向你实际应用包内的辅助程序，而 Diagrammix 会持续对其进行签名和更新。

重启 Claude Desktop。Diagrammix 的工具就会出现在聊天中。

3. 配置 Claude Code（CLI）

Claude Code 原生支持 Streamable HTTP——无需桥接程序。添加一个类型为 HTTP 的 MCP 服务器，指向：

http://localhost:8420/mcp

请参阅 Claude Code 的 MCP 文档，了解所需的命令或配置文件。

4. 配置 Codex

Codex（应用、CLI 和 IDE 扩展共用一份 MCP 配置）通过 Streamable HTTP 连接。可以用以下任一方式配置：

方式 A — config.toml。 在 Diagrammix 设置的 Codex 部分点击 复制配置，并粘贴到 ~/.codex/config.toml 中：

[mcp_servers.diagrammix]
url = "http://localhost:8420/mcp"
enabled = true
default_tools_approval_mode = "prompt"
startup_timeout_sec = 20
tool_timeout_sec = 60

方式 B — CLI。 在 Diagrammix 设置中点击 复制命令，或运行：

codex mcp add diagrammix --url http://localhost:8420/mcp

5. 其他 MCP 客户端

任何兼容 MCP 的客户端都可以通过以下方式连接：

传输方式： Streamable HTTP
端点： http://localhost:8420/mcp
协议： 基于 HTTP POST 的 JSON-RPC 2.0

注意： ChatGPT Desktop 需要 HTTPS，不支持直接连接 localhost。

常用工具

Diagrammix 提供了一大批 MCP 工具，其中一些最常用的包括：

工具	作用
`batch_create`	在一个撤销步骤中创建大量符号和连接器
`apply_diagram_plan` / `preview_diagram_plan`	校验一个结构化的图表方案，然后将其作为一个可撤销的步骤应用
`get_elements` / `update_element`	读取和修改现有元素
`apply_layout`	运行自动布局
`create_mindmap`	从嵌套树或 Markdown 大纲构建思维导图
`import_mermaid`	从 Mermaid 文本插入图表
`generate_radial_diagram`	生成放射状信息图——分段环、圆形或花瓣形——并带有标签和颜色
`combine_shapes`	布尔运算（并集、减去、相交、排除重叠）
`create_artboard`	添加用于导出的画板
`set_document_palette` / `apply_palette`	存储文档配色方案，并用它重新设置图表主题
`create_style` / `apply_style`	创建和应用自定义样式
`export_svg`、`export_png`、`export_vsdx`、`export_mermaid`	导出图表或所选内容；`export_vsdx` 会将每个画板转换为一个 Visio 页面
`undo` / `redo`	向前或向后逐步执行更改

使用示例

创建流程图

"创建一个包含 Start、Decision、Process A、Process B 和 End 的流程图。将 Start 连接到 Decision，Decision 连接到 Process A（Yes）和 Process B（No），两个 Process 都连接到 End。"

AI 会使用 batch_create 在一个撤销步骤中放置所有符号和连接器。

修改现有图表

"将所有矩形的填充颜色改为蓝色，并将文本加粗。"

AI 会先用 get_elements 读取你的元素，然后用 update_element 逐一更新。

自动布局

"应用从上到下的布局，行间距为 60 像素。"

AI 会以你偏好的方向和间距调用 apply_layout。

复刻图片中的外观

"这是我们品牌图表风格的截图，请复刻这些形状和颜色，做成一个我可以复用的自定义模板和样式。"

把参考图片交给助手，它就能生成匹配的 SVG 形状和箭头，并将它们组装成一个匹配的自定义模板，以及一个匹配的自定义样式。它会用到 create_custom_template、add_custom_shape、add_custom_arrowhead、create_style 等工具，因此得到的是一套可复用的素材包，而不是一次性的绘图。

小贴士

从描述开始 — 描述越具体，效果越好
迭代 — 初次创建后，可以让 AI 调整颜色、标签或布局
放心撤销 — 所有 AI 的更改都支持 Cmd+Z 撤销
使用标注符号 — 让 AI 使用特定的标注包以保持样式一致
批量操作更好 — 对于新图表，AI 会在一步内创建所有内容，这样撤销会撤回整体