diag2md-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-mcp

MCPサーバー設定

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つのコアツールを公開しています：

サーバー設定

MCPサーバーの設定は環境変数でカスタマイズできます：

`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

ライセンス

MIT © polymatic.ventures