Foundry VTT MCP Bridge

Foundry VTTをModel Context Protocol (MCP) を通じてClaude Desktopに接続し、AIを活用したキャンペーン管理を実現します。現在はDungeons and Dragons 第5版およびPathfinder 第2版をサポートしています。MCPツールの大部分はシステムに依存しませんが、キャラクター作成およびコンペンディウムツールはD&D5eおよびPF2Eでのみ動作します。

概要

Foundry MCP Bridgeを使用すると、Foundry VTTのゲームデータと自然なAI会話が可能になります：

• クエスト作成: 世界観やジャーナルに存在する内容を組み込んだプロンプトからクエストを作成

• キャラクター管理: キャラクターのステータス、能力、情報を照会

• コンペンディウム検索: 自然言語を使用してアイテム、呪文、クリーチャーを検索

• コンテンツ作成: シンプルなプロンプトからアクター、NPC、クエストジャーナルを生成

• シーン情報: 現在のシーンデータやワールドの詳細にアクセス

• ダイス連携: プレイヤーをターゲットにしたインタラクティブなロールリクエスト

• キャンペーン管理: マルチパートクエストおよびキャンペーンの追跡

• マップ生成: プロンプトからマップを作成し、オプションのComfyUIコンポーネントを使用してFoundry VTTのシーンに自動アップロード

このプロジェクトはClaude Codeの支援を受けて構築されました。このプロジェクトを気に入っていただけた場合は、Patreonでのサポートをご検討ください。

Related MCP server: Coreflux MCP Server

インストール

前提条件

• Foundry VTT v13

• MCPサポートを備えたClaude Desktop

• Windows (自動インストーラー用) または Node.js 18+ (手動インストール用)

オプション1: Windowsインストーラー

Windowsインストーラーのビデオガイド

1. Releases から最新の FoundryMCPServer-Setup-vx.x.x.exe をダウンロードします

2. インストーラーを実行します。以下の処理が行われます：

   • バンドルされたNode.jsランタイムと共にMCPサーバーをインストール

   • Claude DesktopのMCPサーバー設定を構成

   • オプションでFoundryモジュールとComfyUIマップ生成をVTTインストール先にインストール

   • インストール中にGPUタイプに合わせてCudaバージョンを選択

3. Claude Desktopを再起動します

4. Foundryのモジュール管理で「Foundry MCP Bridge」を有効にします

オプション2: Macインストーラー

1. Releases から最新の FoundryMCPServer-vx.x.x.dmg をダウンロードします

2. dmg内のパッケージインストーラーを実行します。以下の処理が行われます：

   • DMGを開き、PKGインストーラーをダブルクリック

   • Claude DesktopのMCPサーバー設定を構成

   • オプションでFoundryモジュールとComfyUIマップ生成をFoundry VTTインストール先にインストール

3. Claude Desktopを再起動します

4. Foundryのモジュール管理で「Foundry MCP Bridge」を有効にします

オプション3: 手動インストール

Foundryモジュールのインストール

1. Foundry VTT v13を開きます

2. Foundryのアドオンメニューでモジュールのインストールを選択します

3. ウィンドウ下部にマニフェストURLとして https://github.com/adambdooley/foundry-vtt-mcp/blob/master/packages/foundry-module/module.json を追加し、インストールをクリックします

4. モジュール管理で「Foundry MCP Bridge」を有効にします

   • モジュールIDやフォルダ名は変更しないでください。 MCPバックエンドとClaude統合の両方が、foundry-mcp-bridge というディレクトリにモジュールが存在することを前提としています。module.json 内のIDを変更するとソケットルーティングが壊れ、Claudeがバックエンドを認識できなくなります。

MCPサーバーのインストール

# Clone repository
git clone https://github.com/adambdooley/foundry-vtt-mcp.git
cd foundry-vtt-mcp

# Install dependencies and build
npm install
npm run build

Claude Desktopの設定

Claude Desktopの設定ファイル (claude_desktop_config.json) に以下を追加します：

{
  "mcpServers": {
    "foundry-mcp": {
      "command": "node",
      "args": ["path/to/foundry-vtt-mcp/packages/mcp-server/dist/index.js"],
      "env": {
        "FOUNDRY_HOST": "localhost",
        "FOUNDRY_PORT": "31415"
      }
    }
  }
}

Claude Desktopを起動すると、MCPサーバーが開始されます。

はじめに

1. Foundry VTTを起動し、ワールドを読み込みます

2. Claude Desktopを開きます

3. 現在読み込んでいるFoundryワールドについてClaudeとチャットします

使用例

接続後、Claude Desktopに以下のように尋ねてみてください：

• "Clarkというキャラクターのステータスを見せて"

• "遭遇戦用にCR 12の人型クリーチャーをすべて探して"

• "行方不明の村人を調査するクエストを作成して"

• "Tulkasの隠密判定をロールして"

• "現在のFoundryシーンには何がある？"

• "FoundryでRiverside Cottageの小さなマップを作成して"

機能

• 36種類のMCPツール: ClaudeがFoundryと対話可能

• キャラクター管理: ステータス、能力、インベントリ、詳細なエンティティ情報へのアクセス

• トークン操作: トークンの移動、更新、削除、状態管理

• 強化されたコンペンディウム検索: CR、タイプ、能力などによる即時フィルタリング

• コンテンツ作成: アクター、NPC、クエストジャーナルの生成

• キャンペーン管理: 進捗ダッシュボードを備えたマルチパートクエスト追跡

• インタラクティブなダイスシステム: Claudeからプレイヤーへ様々なダイスロールリクエストを送信

• アクターの所有権: キャラクターやトークンのプレイヤー権限を管理

• GM専用: MCP Bridgeはゲームマスターユーザーにのみ接続

• マップ生成: プロンプトからバトルマップを生成するポータブルなComfyUIバックエンド

• リモート接続: ブラウザ経由で開始されるWebRTC接続（Google Chromeでテスト済み）をMCPサーバーおよびComfyUIへ提供

• WindowsおよびMacインストーラー: Claude Desktop用Foundry MCPサーバー、Foundry VTTモジュール、依存関係を含むComfyUIバックエンドの自動インストール

MCPツール

• 1 get-world-info

• 2 list-scenes

• 3 get-current-scene

• 4 get-available-conditions

• 5 list-compendium-packs

• 6 list-characters

• 7 get-character

• 8 search-character-items

• 9 get-character-entity

• 10 get-token-details

• 11 toggle-token-condition (add)

• 12 toggle-token-condition (remove)

• 13 update-token

• 14 search-compendium

• 15 get-compendium-item

• 16 get-compendium-entry-full

• 17 list-creatures-by-criteria

• 18 list-journals

• 19 create-quest-journal

• 20 update-quest-journal

• 21 search-journals

• 22 link-quest-to-npc

• 23 list-actor-ownership

• 24 assign-actor-ownership

• 25 remove-actor-ownership

• 26 move-token

• 27 use-item

• 28 request-player-rolls

• 29 generate-map

• 30 check-map-status

• 31 cancel-map-job

• 32 switch-scene

• 33 create-actor-from-compendium

• 34 list-dsa5-archetypes

• 35 create-dsa5-character-from-archetype

• 36 create-campaign-dashboard

設定

• Enhanced Creature Index: 「Enhanced Index」ボタンを押すと、強化されたクリーチャーインデックスのサブメニューに移動します（詳細は後述）

• Map Generation Service Configuration: 「Map Generation」ボタンを押すと、マップ生成サービスのサブメニューに移動します（詳細は後述）

• Enable MCP Bridge: デフォルトでチェックされており、ステータスが接続済みと表示されるはずです。アドオン自体を無効にすることなく、ゲーム内でMCP Bridge接続をオフにするために使用できます。

• Connection Type: 接続タイプの自動検出用に「Auto」に設定できます。また、インターネット接続用に「WebRTC」、ローカル接続用に「Websocket」を強制することも可能です。

• Websocket Server Host: Claude Desktop MCPサーバーの場所のIPアドレス。ローカルネットワークのWebsocket接続でのみ使用されます。リモートサーバーはWebRTCを使用します。デフォルトはlocalhostです。

• Allow Write Operations: これをオフにすると、Claudeがワールドコンテンツに変更を加えることを防ぎ、読み取り専用に制限します。

• Max Actors Per Request: 1つのリクエストから大量のアクターが作成されるのを防ぐための安全装置です。複数のリクエストによって作成されるキャラクターの総数を制限するものではありません。

• Show Connection Messages: Foundry MCP Bridgeの接続バナーメッセージをオフにできます。

• Auto-Reconnect on Disconnect: 接続が切断された場合に自動的に再接続を試みます。

• Connection Check Frequency: 接続ステータスを確認する頻度です。

Enhanced Creature Index サブメニュー

• Rebuild Creature Index: 問題が発生した場合や、コンペンディウムの変更と同期していない場合に、クリーチャーインデックスを再構築します。

• Enable Enhanced Creature Index: Claudeがワールドファイル内にメタデータを構築して検索精度を向上させるため、オンのままにしておく必要があります。

• Auto-Rebuild Index on Pack Changes: まだ完全にはテストされていない実験的な機能です。

Map Generation Service サブメニュー

• Service Status: 「Check Status」、「Start Service」、「Stop Service」の3つのボタンがあります。これらのボタンは、Foundry MCP Bridgeから、Claude Desktopアプリケーションによって開始されるComfyUIバックエンドへの接続を監視および制御するのに役立ちます。

• Auto-start Map Generation Service: Foundryワールドの起動時にComfyUIサービス接続を自動的に開始するかどうかを制御します。

• Generation Quality: ComfyUI内のSDXLチェックポイントによって生成されるマップの品質を制御します。「Low」は8ステップ、「Medium」は20ステップ、「High」は35ステップの生成を使用します。この画像生成で使用されるD&D Battlemaps SDXL Upscale v1.0チェックポイントは35ステップの使用を推奨していますが、ローエンドのGPUやCUDA非搭載のGPUでは、生成に数分かかります。これらのオプションにより、品質を犠牲にしてマップを高速に生成するトレードオフが可能です。

アーキテクチャ

Claude Desktop ↔ MCP Protocol ↔ MCP Server ↔ WebSocket ↔ Foundry Module ↔ Foundry VTT
                                     ↓
                              ComfyUI Service
                              (AI Map Generation)

• Foundry Module: Foundry VTT内での安全なデータアクセスを提供

• MCP Server: Claude Desktopとの通信を処理する外部Node.jsサーバー

• Map Generation Service: Claude Desktopによって生成されるヘッドレスComfyUIバックエンド

• APIキー不要: 既存のClaude Desktopサブスクリプションを使用

セキュリティと権限

• GM専用アクセス: すべての機能がゲームマスターユーザーに制限されています

• 構成可能な権限: Claudeがアクセスおよび変更できるデータを制御

• セッションベースの認証: Foundryの組み込み認証システムを使用

システム要件

• Foundry VTT: バージョン13

• Claude Desktop: MCPサポートを備えた最新バージョン

• Claude Pro/Maxプラン: MCPサーバーへの接続に必要

• オペレーティングシステム: Windows 10/11 (インストーラー)、またはその他のOS/Node.js 18+を搭載した手動Windowsインストール

• GPU要件: 8GB以上のVRAMを搭載したGPU

スキーマ・スモークテスト

MCPスキーマ・スモークテストは、ツールスキーマが正しく読み込まれ、過度に厳格な additionalProperties のデフォルトが適用されていないことを検証します。

npm -w @foundry-mcp/server run build
npm run test:mcp:schema

サポートと開発

• Issues: バグ報告は GitHub Issues まで

• YouTubeチャンネル: 更新情報やチュートリアルを購読

• ドキュメント: TypeScriptで構築されており、包括的なドキュメントが含まれています

• ライセンス: MITライセンス (インストーラー用のバンドルコンポーネントには追加のサードパーティライセンスが含まれています)