Network Diagram MCP Server

@modelcontextprotocol/sdkを使用したMCPサーバーで、ネットワークダイアグラムの作成と可視化を行います。MCPサーバーとして動作しながら、同時にWebインターフェースも提供します。

機能

MCPサーバー: Claude等のLLMクライアントから利用可能なツールを提供
Webインターフェース: リアルタイムでネットワークダイアグラムを可視化
REST API: プログラムからダイアグラムを操作可能

インストール

npm install

ビルド

npm run build

起動方法

1. 標準的な起動（MCPサーバー + Webサーバー）

npm start

起動後、以下が利用可能になります：

MCPサーバー: stdin/stdoutで通信
Webインターフェース: http://localhost:3000
REST API: http://localhost:3000/api

2. カスタムポートで起動

PORT=8080 npm start

テストデータの投入

サーバーが起動している状態で、別のターミナルからテストデータを投入できます。

# サーバーを起動（ターミナル1）
npm start

# テストデータを投入（ターミナル2）
npm run test-data

テストデータスクリプトは以下を実行します：

既存のダイアグラムをクリア
Webアプリケーションアーキテクチャのサンプルを作成
- 11個のノード（ブラウザ、CDN、ロードバランサー、Webサーバー、DB等）
- 14個のエッジ（ノード間の接続）

実行後、http://localhost:3000 でダイアグラムを確認できます。

MCPツール

以下のツールが利用可能です：

`add_node`

ネットワークダイアグラムにノードを追加します。

パラメータ:

id (string, required): ノードのID
label (string, required): ノードのラベル
x (number, optional): X座標
y (number, optional): Y座標

例:

{
  "id": "server1",
  "label": "Webサーバー",
  "x": 100,
  "y": 100
}

`add_edge`

ネットワークダイアグラムにエッジ（接続）を追加します。

パラメータ:

from (string, required): 開始ノードのID
to (string, required): 終了ノードのID
label (string, optional): エッジのラベル

例:

{
  "from": "server1",
  "to": "db1",
  "label": "SQL"
}

`clear_diagram`

ネットワークダイアグラムをクリアします。

REST API

`GET /api/diagram`

現在のダイアグラムデータを取得します。

レスポンス例:

{
  "nodes": [
    {"id": "server1", "label": "Webサーバー", "x": 100, "y": 100}
  ],
  "edges": [
    {"from": "server1", "to": "db1", "label": "SQL"}
  ],
  "lastUpdate": "2024-01-01T00:00:00.000Z"
}

`POST /api/diagram/node`

ノードを追加します。

リクエストボディ:

{
  "id": "server1",
  "label": "Webサーバー",
  "x": 100,
  "y": 100
}

`POST /api/diagram/edge`

エッジを追加します。

リクエストボディ:

{
  "from": "server1",
  "to": "db1",
  "label": "SQL"
}

`DELETE /api/diagram`

ダイアグラムをクリアします。

`GET /api/health`

ヘルスチェックエンドポイント。

Webインターフェース

http://localhost:3000 にアクセスすると、以下の機能を持つWebインターフェースが表示されます：

リアルタイムでダイアグラムを可視化
マウスドラッグでビューポートを移動
マウスホイールでズームイン/アウト
2秒ごとに自動更新
ノード数、エッジ数の統計表示
最終更新日時の表示
手動更新ボタン
クリアボタン

Claude Desktopとの統合

Claude Desktopの設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加：

{
  "mcpServers": {
    "network-diagram": {
      "command": "node",
      "args": ["/path/to/network-diagram-mcp/build/index.js"]
    }
  }
}

使用例

Claudeでの使用例

ユーザー: Webアプリケーションのアーキテクチャ図を作成してください

Claude:
1. add_node({ id: "client", label: "ブラウザ" })
2. add_node({ id: "lb", label: "ロードバランサー" })
3. add_node({ id: "web", label: "Webサーバー" })
4. add_node({ id: "db", label: "データベース" })
5. add_edge({ from: "client", to: "lb", label: "HTTPS" })
6. add_edge({ from: "lb", to: "web", label: "HTTP" })
7. add_edge({ from: "web", to: "db", label: "SQL" })

ダイアグラムを作成しました。http://localhost:3000 で確認できます。

curlでの使用例

# ノードを追加
curl -X POST http://localhost:3000/api/diagram/node \
  -H "Content-Type: application/json" \
  -d '{"id": "server1", "label": "Webサーバー", "x": 200, "y": 200}'

# エッジを追加
curl -X POST http://localhost:3000/api/diagram/edge \
  -H "Content-Type: application/json" \
  -d '{"from": "server1", "to": "db1", "label": "SQL"}'

# ダイアグラムを取得
curl http://localhost:3000/api/diagram

# ダイアグラムをクリア
curl -X DELETE http://localhost:3000/api/diagram

ライセンス

ISC

network-diagram-mcp