# @diagrammo/dgmo-mcp 中文文档

规范地址：https://npmcn.com/package/%40diagrammo/dgmo-mcp/

版本：0\.29\.15
npm 元数据更新时间：2026-11-08T15:46:37.878Z
中文译文更新时间：2026-11-13T04:02:53.575Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40diagrammo/dgmo-mcp
原文对照：https://npmcn.com/package/%40diagrammo/dgmo-mcp/?lang=original
项目主页：https://github.com/diagrammo/dgmo-mcp#readme
源码仓库：https://github.com/diagrammo/dgmo-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.9 MB，422 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.6
- 运行依赖：5 个
- 首次发布：2026-03-01T02:44:45.694Z
- 最新版本发布：2026-11-08T15:46:37.464Z
- 近 30 天下载量：2334（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：87（近 12 个月 87 个）

## 中文简介

MCP服务器用于渲染DGMO图——SVG/PNG输出,浏览器预览,HTML报告,和50+图表类型. 与克洛德桌面,克洛德代码,以及任何MCP客户端合作.

## 安装

```sh
npm install @diagrammo/dgmo-mcp
```

也可以使用：`pnpm add @diagrammo/dgmo-mcp`、`yarn add @diagrammo/dgmo-mcp`、`bun add @diagrammo/dgmo-mcp`

## README

# @ diagrammo/ dgmo- mcp

**把对话变成一个真实的图表——不留下你的AI工具.**

[![npm version](https://img.shields.io/npm/v/@diagrammo/dgmo-mcp.svg)](https://www.npmjs.com/package/@diagrammo/dgmo-mcp) [![npm downloads](https://img.shields.io/npm/dm/@diagrammo/dgmo-mcp.svg)](https://www.npmjs.com/package/@diagrammo/dgmo-mcp) [![license](https://img.shields.io/npm/l/@diagrammo/dgmo-mcp.svg)](https://npmcn.com/package/%40diagrammo/dgmo-mcp/LICENSE)

这个MCP服务器赋予克洛德(以及任何MCP相容的AI工具)渲染能力 **序列图、流程图、ER图、C4结构图、Gantt图和40+ 其他图表类型** 简洁的文字标记,然后将结果全部交给 编辑精细. 聊天时询问图表; 获取真实的图表 .

<table><tbody><tr><td><img alt="Sequence diagram" src="https://raw.githubusercontent.com/diagrammo/dgmo-mcp/main/assets/sequence.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"></td><td><img alt="C4 architecture diagram" src="https://raw.githubusercontent.com/diagrammo/dgmo-mcp/main/assets/c4.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"></td></tr><tr><td><img alt="Gantt chart" src="https://raw.githubusercontent.com/diagrammo/dgmo-mcp/main/assets/gantt.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"></td><td><img alt="Flowchart" src="https://raw.githubusercontent.com/diagrammo/dgmo-mcp/main/assets/flowchart.png" loading="lazy" decoding="async" referrerpolicy="no-referrer"></td></tr></tbody></table>

## 尽你所能

用简单的语言问—— _"将认证流描述为序列"_, (中文(简体) ), _"图上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服务](https://npmcn.com/package/%40diagrammo/dgmo-mcp/#readme-serving-over-http)。 。 。 .

## MCP 服务器之外

MCP 服务器是一个切入点 **[图表](https://diagrammo.app/)** 整个 生态系统建立在同样的DGMO标记之上. 在聊天中产生, 精炼在真正的编辑, 嵌入任何地方:

-   **[图表.app](https://diagrammo.app/)** ——桌面应用. `open_in_app` 丢入一个 AI生成的图表直入其中,有活预览,调色板,并导出.
-   **[互联网档案馆的存檔,存档日期2013-12-02](https://online.diagrammo.app/)** ——全版编辑 浏览器,零安装. `share_diagram` URL在这里打开.
-   **文件集成** 将 DGMO 栅栏的代码块放入您的文档网站: [评论- dgmo](https://www.npmjs.com/package/remark-dgmo), (中文(简体) ), [天文学家](https://www.npmjs.com/package/astro-dgmo), (中文(简体) ), [多库龙- 插图- dgmo](https://www.npmjs.com/package/docusaurus-plugin-dgmo), (中文(简体) ), [fumadocs-dgmo (法语)](https://www.npmjs.com/package/fumadocs-dgmo)。 。 。 .
-   **欧比多语Name** - 那个 _图表_ 社区插件使 DGMO 在您的金库中.
-   **国 际** —— 说 `npx @diagrammo/dgmo-cli file.dgmo -o out.png`,或安装到 `npm install -g @diagrammo/dgmo-cli` (macOS和Linux).

> **一个标记,到处都是.** 您在此生成的图表在 应用,在你的文档, 和Obsidian—— 因为他们都说DGMO.

**[– 在图解.app中免费尝试](https://diagrammo.app/)**

## 设置

### 最轻松的——一个命令

安装 [`dgmo`](https://www.npmjs.com/package/@diagrammo/dgmo-cli) CLI和让它连接所有的东西:

```bash
npm install -g @diagrammo/dgmo-cli   # macOS and Linux
dgmo install                         # auto-detects Claude Code, Codex, Claude Desktop, Cursor, …
```

更喜欢乡下人还是派克曼? 见 [图表.app/dev](https://diagrammo.app/dev#cli)。 。 。 .

`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`数字 :

```json
{
  "mcpServers": {
    "dgmo": {
      "command": "npx",
      "args": ["-y", "@diagrammo/dgmo-mcp"]
    }
  }
}
```

如果你拥有 `dgmo` 安装了CLI, `{ "command": "dgmo", "args": ["mcp"] }` 还行 保存后重新启动客户端——工具自动出现.

### 为HTTP服务

上面的设置将服务器启动为子进程, 并按其标准与其交谈 输入和输出。 这需要服务器和客户端在同一台机器上。 他们在哪里 不是一个——一个托管代理平台,一个容器,一个服务器,由几个人共享—— 以 HTTP 结尾开始 。 同一端点也适合一台机器 当你 想要一个单一的服务器为您使用的每个 AI 工具运行 :

```bash
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`数字 :

```ini
[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
```

```bash
systemctl --user daemon-reload
systemctl --user enable --now dgmo-mcp
```

**macOS——发射剂**,保存为 `~/Library/LaunchAgents/app.diagrammo.mcp.plist`数字 :

```xml
<?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>
```

```bash
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)。 见 [隐私术语](https://diagrammo.app/terms#mcp-privacy)。 。 。 .

## 发展枢纽(AI调制工具)

```bash
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)

开发设置和发布工作流程 [捐款额](https://npmcn.com/package/%40diagrammo/dgmo-mcp/CONTRIBUTING.md)。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @diagrammo/dgmo-mcp 是什么？

MCP服务器用于渲染DGMO图——SVG/PNG输出,浏览器预览,HTML报告,和50\+图表类型\. 与克洛德桌面,克洛德代码,以及任何MCP客户端合作\.

### 如何安装 @diagrammo/dgmo-mcp？

在项目目录运行 npm install @diagrammo/dgmo-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dgmo-mcp，可以用 npx dgmo-mcp 直接运行。

### @diagrammo/dgmo-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @diagrammo/dgmo-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @diagrammo/dgmo-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.6。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @diagrammo/dgmo-mcp 可以商用吗？

@diagrammo/dgmo-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @diagrammo/dgmo-mcp 的下载量有多少？

根据 npm 官方下载统计，@diagrammo/dgmo-mcp 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,334 次，日均约 78 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @diagrammo/dgmo-mcp 还在维护吗？

最新版本 0\.29\.15 发布于 2026/11/08（4 天前）；至今共发布 87 个版本，其中过去 12 个月发布了 87 个；首次发布于 2026/03/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。