Diagrams

diagrams-mcp-server

クラウドアーキテクチャ図、フローチャート、シーケンス図などを生成する MCP サーバーです。mingrammer/diagrams、Mermaid、PlantUML の3つのレンダリングエンジンを使用します。

はじめに

ローカルへのインストール

前提条件

デフォルトのローカル／インプロセスレンダリングモードでは、Graphviz が必要です。Mermaid CLI と PlantUML は任意です。これらの特定のレンダリングエンジンをローカルで使用する場合にのみインストールしてください。

サーバーをインストールする

uvx を使用する場合（推奨）：

uvx diagrams-mcp-server

pip を使用する場合：

pip install diagrams-mcp-server

ソースからインストールする場合：

pip install git+https://github.com/ByteOverDev/diagrams-mcp.git

MCP クライアントを設定する

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "uvx",
      "args": ["diagrams-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "diagrams-mcp-server"
    }
  }
}

claude mcp add diagrams-mcp -- uvx diagrams-mcp-server

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "uvx",
      "args": ["diagrams-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "diagrams-mcp-server"
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "uvx",
      "args": ["diagrams-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "diagrams-mcp-server"
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "uvx",
      "args": ["diagrams-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "diagrams-mcp": {
      "command": "diagrams-mcp-server"
    }
  }
}

{
  "servers": {
    "diagrams-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["diagrams-mcp-server"]
    }
  }
}

{
  "servers": {
    "diagrams-mcp": {
      "type": "stdio",
      "command": "diagrams-mcp-server"
    }
  }
}

利用可能なツール

検出

• list_providers() → list[str] — すべての図のプロバイダー（aws、gcp、k8s、azure、onprem など）を一覧表示します
• list_services(provider) → list[str] — プロバイダー内のサービスカテゴリを一覧表示します（例：aws → compute、database、network）
• list_nodes(provider, service) → list[dict] — プロバイダーとサービスの組み合わせに対応するノードクラスを、インポートパスとともに一覧表示します
• search_nodes(query) → list[dict] — すべてのプロバイダーを対象に、キーワードでノードを検索します（例：「postgres」、「lambda」）

レンダリング

• render_diagram(code) → Image (PNG) — サンドボックス化されたサブプロセスで、mingrammer/diagrams を使用した Python スクリプトを実行します。レンダリング済みのクラウドアーキテクチャ図を返します。
• render_mermaid(definition) → Image (PNG/SVG) — Mermaid の図の定義をレンダリングします（フローチャート、シーケンス図、クラス図、ER 図、状態図、ガント図など）。
• render_plantuml(definition) → Image (PNG) — PlantUML の図の定義をレンダリングします（シーケンス図、クラス図、コンポーネント図、アクティビティ図、状態図、デプロイメント図）。

プロバイダー間の同等サービス

• find_equivalent(node, target_provider?) → dict — クラウドプロバイダー間で同等のサービスを検索します（例：EC2 → GCP の ComputeEngine）。
• list_categories() → list[dict] — すべての30のインフラストラクチャロールカテゴリと、プロバイダー間で対応付けられたノードを一覧表示します。

リソース

サーバーは、MCP リソース URI からアクセスできるリファレンスドキュメントを提供します。

使用例

クラウドアーキテクチャ（mingrammer/diagrams）

「ALB が 2 つの ECS サービスにルーティングし、RDS と ElastiCache をバックエンドにする AWS アーキテクチャを描いてください」

from diagrams import Diagram, Cluster
from diagrams.aws.network import ALB
from diagrams.aws.compute import ECS
from diagrams.aws.database import RDS, ElastiCache

with Diagram("ECS Service", direction="LR"):
    lb = ALB("ALB")

    with Cluster("ECS Cluster"):
        services = [ECS("Web"), ECS("API")]

    lb >> services
    services[0] >> ElastiCache("Cache")
    services[1] >> RDS("Database")

フローチャート（Mermaid）

「CI/CD パイプラインを示すフローチャートを作成してください」

シーケンス図（PlantUML）

「クライアント、API ゲートウェイ、認証サービス間の認証フローを示してください」

@startuml
Client -> "API Gateway": POST /login
"API Gateway" -> "Auth Service": Validate credentials
"Auth Service" --> "API Gateway": JWT token
"API Gateway" --> Client: 200 OK + token
Client -> "API Gateway": GET /data (Bearer token)
"API Gateway" -> "Auth Service": Verify token
"Auth Service" --> "API Gateway": Valid
"API Gateway" --> Client: 200 OK + data
@enduml

開発

# Clone and install
git clone https://github.com/ByteOverDev/diagrams-mcp.git
cd diagrams-mcp
pip install -e ".[dev]"

# Run tests
pytest

# Lint and format
ruff check .
ruff format .

# Run the MCP server locally (stdio mode)
diagrams-mcp-server

ファサード／レンダラー分離モード

ホスト型のデプロイでは、MCP サーバーを軽量なファサードとして実行し、レンダリング処理を別のレンダラーサービスに委任できます。これにより、常時稼働する MCP プロセスを小さく保ちながら、Graphviz、Chromium、Mermaid CLI、Java、PlantUML はレンダラーイメージ内だけに配置できます。

# Terminal 1: renderer service
RENDERER_HOST=0.0.0.0 RENDERER_PORT=8001 diagrams-renderer-server

# Terminal 2: HTTP MCP facade delegating to the renderer
FASTMCP_TRANSPORT=http \
FASTMCP_HOST=0.0.0.0 \
FASTMCP_PORT=8000 \
DIAGRAMS_RENDERER_MODE=remote \
DIAGRAMS_RENDERER_URL=http://127.0.0.1:8001 \
diagrams-mcp-server

Docker／Railway の例が含まれています。

主な環境変数：

対応プロバイダー

render_diagram ツールは、mingrammer/diagrams ライブラリのすべてのプロバイダーに対応しています。対象には次のノードが含まれます。

AWS、GCP、Azure、Kubernetes、On-Premise、AlibabaCloud、OCI、OpenStack、DigitalOcean、Elastic、Outscale、Generic、Custom。

list_providers() と search_nodes(query) を使って、利用可能なノードを確認できます。

ライセンス

MIT