diag2md-mcp
Officialdiag2md-mcp
AIコーディングエージェントにDraw.io C4およびUMLアーキテクチャのガードレールと変換機能を提供するModel Context Protocol (MCP)サーバー。
diag2md-mcp は、C4およびUMLダイアグラムをリアルタイムに構造化されたMermaid Markdownへ変換することで、Draw.ioアーキテクチャ図(. xml、. drawio)とAIコーディングエージェント(Antigravity、Cursor、Claude Desktop、VS Code MCPクライアントなど)を橋渡しします。
提供: diag2md。
主な機能
自動ワークスペース検出: 設定可能なglobパターン(
**/architecture/**/*.xml、**/*.drawio)に一致するDraw.ioダイアグラムファイルをプロジェクトディレクトリからスキャンします。高性能インメメモリ変換: サブシェルプロセス起動のオーバーヘッドなしに、Draw.io XMLモデルをインメメモリでMermaid C4 & UML Markdownに変換します。
AIコンテキストプロバイダー (
convert_digrams_read): ダイアグラムを動的に読み取って変換し、チャットセッション中にAIコーディングアシスタントへリッチなアーキテクチャコンテキストを直接提供します。ダイアグラム一括同期 (
convert_digrams_write): ダイアグラムソースと一緒に.mdファイルを生成することで、アーキテクチャドキュメントを最新の状態に保ちます。
Related MCP server: drawio-mcp
クイックスタート
npx での実行
MCPサーバーは事前インストールなしで直接実行できます:
npx -y diag2md-mcpグローバルインストール
npm install -g diag2md-mcpMCPサーバー設定
diag2md-mcp をお気に入りのAIアシスタントやMCPクライアントに接続するには、クライアント設定ファイル(例: mcp_config.json、claude_desktop_config.json、Cursor、AntigravityのMCP設定)にサーバーを追加します。
推奨(グローバルインストール済みパッケージ)
{
"mcpServers": {
"diag2md-mcp": {
"command": "diag2md-mcp"
}
}
}代替案: ローカルビルドのソース
{
"mcpServers": {
"diag2md-mcp": {
"command": "node",
"args": ["/path/to/diag2md-mcp/dist/index.js"]
}
}
}代替案: npx によるオンデマンド実行
{
"mcpServers": {
"diag2md-mcp": {
"command": "npx",
"args": ["-y", "diag2md-mcp"]
}
}
}MCPツールリファレンス
diag2md-mcp はAIコーディングエージェントに3つのコアツールを公開しています:
Tool Name | Description | Arguments |
| ワークスペース内でglobパターンに一致するすべてのDraw.ioアーキテクチャ図ファイル( |
|
| globパターンに一致するワークスペースのダイアグラムファイルを一括スキャンし、変換して、更新された |
|
| ワークスペースのダイアグラムファイルを一括スキャンし、変換されたMermaid MarkdownをAIアシスタント向けのコンテキストとして直接返します。 |
|
サーバー設定
MCPサーバーの設定は環境変数でカスタマイズできます:
Environment Variable | Description | Default Value | ||||||||
`DIAG2MD_PATTERNS` | ダイアグラムファイルを検出するためのカンマ区切りのglobパターン。 | `/architecture//. xml, **/architecture/. xml, **/*. drawio` | `DIAG2MD_IGNORE` | ファイル検出時に無視するカンマ区切りのglobパターン。 | `/node_mdules/, /dist/, /. git/` | `DIAG2MD_TYPE` | デフォルトの変換ダイアグラムタイプ(`c4` または `uml`)。 | `c4` |
`env` パターンを使用した設定例
MCPサーバーのJSON設定で`env`ブロックを使用すると、カスタム検索パターンを直接設定できます:
{
"mcpServers": {
"diag2md-mcp": {
"command": "diag2md-mcp",
"env": {
"DIAG2MD_PATTERNS": "**/architecture/**/*.xml, **/docs/**/*.drawio",
"DIAG2MD_IGNORE": "**/tmp/**, **/node_modules/**",
"DIAG2MD_TYPE": "c4"
}
}
}
}`patterns` を使用した動的ツール呼び出し例
AIアシスタントやツールは、リクエストごとに検索パターンを動的に上書きすることもできます:
{
"name": "convert_diagrams_read",
"arguments": {
"patterns": [
"**/architecture/**/*.xml",
"**/docs/**/*.drawio"
]
}
}開発
# Clone the repository
git clone https://github.com/diag2md/diag2md-mcp.git
cd diag2md-mcp
# Install dependencies
npm install
# Build TypeScript to JavaScript dist/
npm run build
# Run unit tests
npm run test
# Run type checker
npm run typecheckライセンス
Available Tools
3 toolsconvert_diagrams_readA
Batch scan and convert all workspace diagram files (.xml, .drawio) into Mermaid Markdown, returning their content directly as AI context.
Inputs: patterns, diagramType.
convert_diagrams_writeA
Batch scan workspace diagrams matching glob patterns and convert them to updated .md files on disk.
Inputs: patterns, diagramType.
list_diagramsA
Discover all Draw.io architecture diagram files (.xml, .drawio) in the workspace using glob patterns.
Inputs: ignore, patterns.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
list_diagrams is clearly discovery-only, while the two convert tools are separated by output behavior: _write persists .md files to disk and _read returns content as AI context. There is no meaningful overlap between any pair.
All tool names follow a consistent verb_noun pattern in lowercase snake_case, using the same 'diagrams' resource. The _read/_write suffixes are a coherent way to distinguish output modes, and list_diagrams fits the pattern as an independent discovery action.
Three tools is a well-scoped set for a focused converter utility: discover source files, convert to files, and convert to context. Each tool addresses a distinct workflow step without unnecessary expansion.
The core workflow of finding Draw.io diagrams and converting them to Mermaid Markdown is fully covered in both output modes (disk and context). No obvious dead ends or missing lifecycle operations are apparent for this narrow domain.
Related MCP Connectors
Draw architecture diagrams, UML, planning boards and clickable wireframes from your AI assistant.
Let Claude, Cursor, or ChatGPT author Mermaid diagrams your team can read and share.
Generate dynamic Mermaid diagrams and charts with AI assistance. Customize styles and export diagr…
Create and edit architecture diagrams from your AI agent; get an SVG and a live editable canvas.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables AI agents to programmatically create, modify, and analyze Draw.io diagrams through the Model Context Protocol. Supports generating architectural diagrams, flowcharts, and visualizations with bidirectional communication between AI systems and Draw.io.131,500MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to generate professional UML diagrams (class, use case, activity, sequence) from natural language descriptions, producing editable .drawio files compatible with diagrams.net.7109 npmISC
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to create, read, update, and delete Draw.io diagrams, allowing automated generation of architectural diagrams, flowcharts, and visual documentation.MIT
- AlicenseAqualityBmaintenanceEnables AI coding agents to list, read, create, update, delete, and render PlantUML and Mermaid diagrams, and check them against the actual codebase to detect architecture drift.15100 npm1MIT