Bgg MCP Server

🚀 BoardGameGeek MCP サーバー

このサーバーは、BoardGameGeek XML API を統合したモデルコンテキストプロトコル (MCP) サーバーです。Claude がボードゲームを検索し、ゲームの詳細情報を取得し、ユーザーのコレクションを検索し、その他の機能を利用できるようにします。

✨ 主な機能

このサーバーは以下のツールを提供します：

1. search-games：名前でボードゲームを検索します。
2. get-game-details：特定のボードゲームの詳細情報を取得します。
3. get-hot-games：BoardGameGeek で現在最も人気のあるボードゲームを取得します。
4. get-user-collection：フィルターオプション付きで、ユーザーのボードゲームコレクションを取得します。
5. sync-user-collection：ユーザーの BoardGameGeek からのコレクションを同期します。
6. get-user-plays：ユーザーの最近のボードゲームのプレイ記録を取得します。
7. sync-user-plays：ユーザーの BoardGameGeek からのプレイ記録を同期します。
8. get-similar-games：指定されたゲームに似たボードゲームを取得します。

機能リスト

• [x] 検索
• [x] ゲーム詳細情報の取得
• [x] 人気ゲーム
• [ ] ユーザーのプレイ記録の取得
• [ ] ユーザーのプレイ記録の同期
• [ ] ユーザーのコレクションの取得
• [ ] ユーザーのコレクションの同期
• [ ] 類似ゲームの取得

📦 インストール

前提条件

• Node.js 22.5.0 以上（実験的な SQLite サポートのため）
• npm（依存関係の管理のため）

サーバーの構築

# 依存関係のインストール
npm install

# TypeScript コードのビルド
npm run build

サーバーの直接実行

# --experimental-sqlite フラグが必要
node --experimental-sqlite build/index.js

Docker を使用した実行

# Docker イメージの構築
docker build -t bgg-mcp-server .

# コンテナの実行
docker run --rm -i bgg-mcp-server

💻 使用例

サーバーの動作確認

# サーバーがビルドされていることを確認
npm run build

# 実験的な SQLite フラグを使用してテストスクリプトを実行
node --experimental-sqlite test-mcp.js

テストスクリプトは以下のことを行います：

1. MCP サーバーを起動します。
2. search-games 機能をテストします。
3. get-hot-games 機能をテストします。
4. 結果とエラーを表示します。

Claude for Desktop との連携

1. Claude for Desktop の設定ファイルを開きます：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Node.js を直接使用して実行するサーバーの設定を追加します：

{
  "mcpServers": {
    "boardgamegeek": {
      "command": "node",
      "args": ["--experimental-sqlite", "/path/to/bgg-mcp-server/build/index.js"]
    }
  }
}

3. Docker を使用する場合（推奨）：

{
  "mcpServers": {
    "boardgamegeek": {
      "command": "bash",
      "args": ["-c", "cd /path/to/bgg-mcp-server && docker build -t bgg-mcp-server . && docker run --rm -i -v \"$(pwd)/data:/app/data\" bgg-mcp-server"]
    }
  }
}

注意: -v フラグはデータディレクトリをマウントするために使用され、データの永続性を確保します。

4. Claude アプリケーションを再起動または再読み込みして設定を適用します。

設定例

{
  "mcpServers": {
    "boardgamegeek": {
      "command": "node",
      "args": ["--experimental-sqlite", "/path/to/bgg-mcp-server/build/index.js"]
    }
  }
}

コマンド例

# プロジェクトの構築
npm install && npm run build

# テストスクリプトの実行
node --experimental-sqlite test-mcp.js

# Docker を使用した実行
docker build -t bgg-mcp-server . && docker run --rm -i bgg-mcp-server

📚 ドキュメント

注意事項

⚠️ 重要提示

• Node.js と npm が正しくインストールされていることを確認してください。
• Docker を使用する場合、データの永続性を確保するためにマウントパスを調整する必要がある場合があります。
• テストスクリプトは追加のログや出力を生成する場合があります。詳細情報はコンソールを確認してください。

以上の手順に従うことで、BoardGameGeek MCP サーバーを正常に設定して実行し、Claude と統合することができます。