@ diagrammo/ dgmo- mcp
把对话变成一个真实的图表——不留下你的AI工具.
这个MCP服务器赋予克洛德(以及任何MCP相容的AI工具)渲染能力 序列图、流程图、ER图、C4结构图、Gantt图和40+ 其他图表类型 简洁的文字标记,然后将结果全部交给 编辑精细. 聊天时询问图表; 获取真实的图表 .
 |
 |
 |
 |
尽你所能
用简单的语言问—— "将认证流描述为序列", (中文(简体) ), "图上Q3计划作为 一个gutt", (中文(简体) ), "把我们的服务画成C4图" - 克劳德写了标记 让它。 标记仍可读和可分:
flowchart Mutiny Resolution
direction-tb
[Sail] Set sail under the captain
{Trouble?} Discontent in the crew?
{Vote} Crew vote called
[Mutiny] Seize the ship
(Sail) -> (Trouble?)
(Trouble?) -Yes-> (Vote)
(Vote) -Mutiny-> (Mutiny)
* 输入上面的流程图。 所有渲染发生 当地 ——无图表数据 离开你的机器.
工具
| 工具 | 它会做什么 | 超过 HTTP |
|---|---|---|
render_diagram | 将 DGMO 标记为 SVG 或 PNG 软件 | 对 |
validate_diagram | 检查标记并报告解析错误, 不渲染 | 对 |
suggest_chart_type | 建议符合描述的图表类型 | 对 |
list_chart_types | 列出所有支持的图表类型, 标记β 类型 | 对 |
get_language_reference | 获取 DGMO 语法文档以准确生成 | 对 |
get_examples | 获取图表类型的工作示例 | 对 |
share_diagram | 得到一个共享 图表.app URL — 将图表交给网页编辑器 | 对 |
open_in_app | 打开图表 直接进入图表桌面应用程序 供编辑 | 没有 |
check_app_installed | 报告桌面应用程序是否安装 | 没有 |
preview_diagram | 绘制一个或多个图表并打开一个 HTML 预览 在浏览器中 | 没有 |
generate_report | 构建一个已磨损的 多节 HTML 报告 带有 ToC 和可选源 | 没有 |
put_space_diagram | 将一个图表写入一个 图表云空间,按文件夹和标题 | 对 |
get_space_diagram | 从 Cloud 空间读取一个图表, 以 id 或 文件夹和标题 | 对 |
list_space_diagrams | 在云空间中列出每个图表 | 对 |
三个空间工具将图发去图克克克莫云. 他们需要一个空间 API 密钥
(在图表账户页上注明) DGMO_API_KEY 在服务器环境中——
从来不是作为工具的争论, 所以钥匙不出现在记录.
share_diagram 财务报告和审定财务报表 open_in_app 是一个 Claude 生成的图
成为你能够精炼、再造和嵌入的东西——见下文.
四个标记 没有 打开浏览器或启动桌面应用程序。 超过HTTP,将 在运行服务器的机器上发生,而不是在您的,所以不提供 那边,看 为HTTP服务。 。 。 .
MCP 服务器之外
MCP 服务器是一个切入点 图表 整个 生态系统建立在同样的DGMO标记之上. 在聊天中产生, 精炼在真正的编辑, 嵌入任何地方:
- 图表.app ——桌面应用.
open_in_app丢入一个 AI生成的图表直入其中,有活预览,调色板,并导出. - 互联网档案馆的存檔,存档日期2013-12-02 ——全版编辑
浏览器,零安装.
share_diagramURL在这里打开. - 文件集成 将 DGMO 栅栏的代码块放入您的文档网站: 评论- dgmo, (中文(简体) ), 天文学家, (中文(简体) ), 多库龙- 插图- dgmo, (中文(简体) ), fumadocs-dgmo (法语)。 。 。 .
- 欧比多语Name - 那个 图表 社区插件使 DGMO 在您的金库中.
- 国 际 —— 说
npx @diagrammo/dgmo-cli file.dgmo -o out.png,或安装到npm install -g @diagrammo/dgmo-cli(macOS和Linux).
一个标记,到处都是. 您在此生成的图表在 应用,在你的文档, 和Obsidian—— 因为他们都说DGMO.
设置
最轻松的——一个命令
安装 dgmo CLI和让它连接所有的东西:
npm install -g @diagrammo/dgmo-cli # macOS and Linux
dgmo install # auto-detects Claude Code, Codex, Claude Desktop, Cursor, …
更喜欢乡下人还是派克曼? 见 图表.app/dev。 。 。 .
dgmo install 配置每个被检测到的助手非交互作用,并将其指向 dgmo mcp,因此没有单独的软件包可以安装或提示回答. 目标一表面 dgmo install claude-code (或 codex, (中文(简体) ), claude-desktop(中文(简体) ).
手动配置
喜欢自己编辑配置吗? 在服务器上指向任何 MCP 客户端 npx (不需要全局安装):
克劳德代码 —— 说 .claude/settings.local.json· ; 克劳德桌面 —— 说 ~/Library/Application Support/Claude/claude_desktop_config.json数字 :
{
"mcpServers": {
"dgmo": {
"command": "npx",
"args": ["-y", "@diagrammo/dgmo-mcp"]
}
}
}
如果你拥有 dgmo 安装了CLI, { "command": "dgmo", "args": ["mcp"] } 还行 保存后重新启动客户端——工具自动出现.
为HTTP服务
上面的设置将服务器启动为子进程, 并按其标准与其交谈 输入和输出。 这需要服务器和客户端在同一台机器上。 他们在哪里 不是一个——一个托管代理平台,一个容器,一个服务器,由几个人共享—— 以 HTTP 结尾开始 。 同一端点也适合一台机器 当你 想要一个单一的服务器为您使用的每个 AI 工具运行 :
dgmo mcp --http # with the dgmo CLI installed
npx -y @diagrammo/dgmo-mcp --http # http://127.0.0.1:3333/mcp
MCP_TRANSPORT=http MCP_PORT=8080 npx -y @diagrammo/dgmo-mcp
每个选项都使用一面旗帜或环境变量,无论您的设置能表达什么:
| 旗帜 | 变量 | 默认 | 什麽 |
|---|---|---|---|
--http | MCP_TRANSPORT=http | 关 | 服务可流式 HTTP 而不是 stdio |
--port <n> | MCP_PORT | 3333 | 要监听的端口 |
--host <addr> | MCP_HOST | 127.0.0.1 | 要绑定的接口 |
--path <path> | MCP_PATH | /mcp | 路径端点答案于 |
--allow-host <h> | MCP_ALLOWED_HOSTS | 循环 | 额外 Host 要接受、 可重复的页眉 |
--allow-origin <o> | MCP_ALLOWED_ORIGINS | 自有来源 | Origin 要接受、 可重复的页眉 |
每个请求都是独立提出的——没有会议,电话之间没有保持任何联系——因此 端点可以同时为多个客户端服务.
服务器没有自己的认证 . 它默认会束缚回转 拒绝载有
Host信头,没有告诉它 期望,或者Origin除本标题外的其他标题--allow-origin说吧,够了 用于同一机器或同一容器内的客户端。 任何能够从 一个更广泛的网络需要你自己的认证 在它的前面,和--allow-host页:1 将联系到的主机名。 在不命名的情况下绑定一个非滚动接口 主机会打印一个警告.
--help 从已安装的版本打印所有这一切.
继续跑
将服务器运行为背景服务, 因此它从登录开始, 如果停止则重新启动 .
改变 dgmo 路径到什么 which dgmo 指纹.
Linux——系统化用户服务,保存为 ~/.config/systemd/user/dgmo-mcp.service数字 :
[Unit]
Description=Diagrammo MCP server over HTTP
After=network.target
[Service]
ExecStart=%h/.local/bin/dgmo mcp --http
Environment=PATH=%h/.local/bin:/usr/local/bin:/usr/bin:/bin
Restart=on-failure
RestartSec=3
[Install]
WantedBy=default.target
systemctl --user daemon-reload
systemctl --user enable --now dgmo-mcp
macOS——发射剂,保存为 ~/Library/LaunchAgents/app.diagrammo.mcp.plist数字 :
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key><string>app.diagrammo.mcp</string>
<key>ProgramArguments</key>
<array>
<string>/opt/homebrew/bin/dgmo</string><string>mcp</string><string>--http</string>
</array>
<key>EnvironmentVariables</key>
<dict><key>PATH</key><string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string></dict>
<key>RunAtLoad</key><true/>
<key>KeepAlive</key><true/>
</dict>
</plist>
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/app.diagrammo.mcp.plist
然后指向每个 AI 工具 http://127.0.0.1:3333/mcp 作为可流-HTTP MCP服务器.
隐私
所有渲染是 当地您的图表标记及其生成的图像永远不会离开
你的机器,除非你明确打电话 share_diagram (将图表编码)
输入图.app URL)。 见 隐私术语。 。 。 .
发展枢纽(AI调制工具)
pnpm hub
一个命令,一个服务器,一个浏览器标签. 中心打开一个有标签的外壳 3个 AI-调试 dev 工具——在它们之间切换上标签,不分开 要记住的端口或命令 :
- 触发调谐 ——编辑驱动的短语/概念词汇
suggest_chart_type,得分提示进行直播,保存回triggers.json。 。 。 . - LLM法官 - 判断图表类型描述与提示
claude -p。 。 。 . - 指导室 ——每类作者 样式指导 服务器
交货
<!-- TIPS -->dgmo 区块language-reference.md切开 输入get_language_reference: 选择一个类型,编辑AI如何被告知样式 它,对已承诺的数据集固定设置运行一个提示(所以输入永远不会移动) ),并看到生成的 DGMO + 并发图像。 这个 picker 双打作为覆盖栏; "Compare 3×" 使得无指导对您的 边视检查提示; 保存验证并写回language-reference.md。 。 。 .
这些工具是 dev-只使用,从未被捆绑入已发布的服务器. (本节)
独立 pnpm harness 财务报告和审定财务报表 pnpm studio 脚本仍然各运行一个工具
如果你想要一个孤立。 )
贡献发布( E)
开发设置和发布工作流程 捐款额。 。 。 .
许可证
麻省理工学院