d2-mcp

D2ダイアグラム言語用のMCPサーバーです。MCP互換のAIアシスタントからD2ダイアグラムをコンパイル、検証、探索できます。

ネイティブのD2 CLIバイナリ（Dockerイメージに自動インストール済み）を使用して、ダイアグラムをSVGおよびPNGにコンパイルします。

ツール

Related MCP server: PlantUML MCP Server

リソース

ローカル開発

前提条件

• Node.js 22+

• D2 CLI — d2lang.com からインストールするか、D2_PATH環境変数にバイナリの場所を設定してください。

• アイコン（オプション） — scripts/download-icons.sh ./icons を実行し、ICONS_DIR=./icons を設定してローカルアイコン解決を有効にします。これを行わない場合、アイコンURLはそのままD2 CLIに渡されます。

npm install
npm run build
npm start

自動リロード付きの開発用：

npm run dev

サーバーはデフォルトでポート3000で起動します（PORT環境変数で上書き可能）。

• ヘルスチェック: GET /health

• MCPエンドポイント: POST /mcp (ストリーミング可能なHTTPトランスポート)

環境変数

デプロイ (Render)

このプロジェクトには、Render へのワンクリックデプロイ用の Dockerfile と render.yaml ブループリントが含まれています。Dockerイメージは、ビルド時に自動的にD2 CLIバイナリをインストールし、すべてのアイコンをダウンロードします。

1. このリポジトリをGitHubにプッシュします

2. Renderで新しい Blueprint を作成し、リポジトリを接続します

3. Renderが自動的に render.yaml を検出し、デプロイします

または、以下のように Web Service を手動で作成します：

• 環境: Docker

• ヘルスチェックパス: /health

• プラン: Free

MCPサーバーへの接続

デプロイ後、ストリーミング可能なHTTP経由で接続するようにMCPクライアントを設定します：

{
  "mcpServers": {
    "d2": {
      "url": "https://your-service.onrender.com/mcp"
    }
  }
}

URLを実際のRenderサービスURL（ローカルの場合は http://localhost:3000/mcp）に置き換えてください。

Compileツールのオプション

ライセンス

MIT