d2-mcp

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

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

ツール

ツール	説明
`compile`	D2ソースコード → SVG/PNG。レイアウトエンジン、テーマ、スケッチモード、ダークテーマ、マルチボードターゲットなどをサポート。
`validate`	レンダリングせずにD2構文をチェック。有効性ステータスとエラーの詳細を返します。
`list_themes`	利用可能なすべてのD2テーマ（ライトおよびダーク）をID付きで一覧表示します。
`list_layouts`	利用可能なレイアウトエンジン（`dagre`、`elk`）を一覧表示します。
`list_icons`	icons.terrastruct.comのアイコンをカテゴリ（AWS、GCP、Azure、K8s、dev、essentials、tech）別に閲覧します。

リソース	説明
`d2://syntax-reference`	Markdown形式の完全なD2言語構文リファレンス。

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環境変数で上書き可能）。

変数	デフォルト	説明
`PORT`	`3000`	HTTPサーバーポート
`D2_PATH`	`d2`	D2 CLIバイナリへのパス（デフォルトでは`PATH`経由で解決）
`ICONS_DIR`	`./icons`	ローカル解決用にダウンロードされたSVGアイコンを含むディレクトリ

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

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

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

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

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

MIT