@diagrammo/dgmo-mcp

用于渲染 DGMO 图表的 MCP 服务器。适用于 Claude Desktop、Claude Code 以及任何兼容 MCP 的 AI 工具。

工具

preview_diagram

将一个或多个 DGMO 图表渲染为 SVG，并在默认浏览器中打开一个独立的 HTML 页面。该页面包含亮色/暗色主题切换和响应式 SVG 布局。

单个图表将渲染为简单的预览页面。多个图表将生成报告样式的布局，并带有目录（当超过 3 个部分时）。如果某些图表渲染失败，成功的图表将显示，失败的图表将显示错误占位符。

generate_report

生成精美的多部分 HTML 报告，并可选择在浏览器中打开。包含标题、可选副标题、自动生成的目录、各部分描述以及时间戳页脚。适用于将项目分析打包成可分享的文档。

Related MCP server: drawio

设置

Claude Code

添加到项目的 .claude/settings.local.json 中：

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

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json 中：

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

保存后重启 Claude Desktop。工具将自动出现。

开发

pnpm install
pnpm build
pnpm typecheck

若要针对 ../dgmo 中检出的未发布 @diagrammo/dgmo 进行迭代，请在安装后使用工作区符号链接覆盖 npm 解析的依赖项：

pnpm install
pnpm link ../dgmo   # symlink node_modules/@diagrammo/dgmo → ../dgmo
pnpm --filter @diagrammo/dgmo build   # ensure dist/ is up to date

pnpm install 会撤销该链接，因此如果依赖项发生变化，请重新运行 pnpm link ../dgmo。

发布

发布通过 .github/workflows/release.yml 进行标签驱动：

1. 提升所有三个文件中的版本号（必须完全匹配 — 工作流会进行验证）：

   • package.json → version

   • manifest.json → version

   • server.json → version 以及 packages[0].version

2. 提交并打标签：

   git commit -am "Release vX.Y.Z"
   git tag vX.Y.Z
   git push && git push --tags

3. 工作流将运行类型检查 + 构建，发布带有来源证明的 npm 包，打包 .mcpb，通过 GitHub OIDC 发布到 MCP 注册表，并将 .mcpb 附加到 GitHub 发布版本中。

所需密钥

• NPM_TOKEN — 作用域为 @diagrammo/* 写入权限的 npm 精细访问令牌。设置 → Secrets and variables → Actions → New repository secret。

MCP 注册表身份验证会自动使用 GitHub OIDC（无需令牌），因为仓库位于 diagrammo 组织下，且服务器命名空间为 io.github.diagrammo/*。