BoardGameGeek MCP サーバー

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

特徴

このサーバーは次のツールを提供します。

search-games : ボードゲームを名前で検索
get-game-details : 特定のボードゲームに関する詳細情報を取得する
get-hot-games : BoardGameGeekで現在最も人気のボードゲームを入手
get-user-collection : フィルタリングオプションを使用してユーザーのボードゲームコレクションを取得する
sync-user-collection : BoardGameGeek からユーザーのコレクションを同期する
get-user-plays : ユーザーの最近のボードゲームプレイを取得する
sync-user-plays : BoardGameGeek からユーザーのプレイを同期する
get-similar-games : 指定したゲームに類似したゲームを取得する

機能チェックリスト

[x] 検索
[x] ゲームの詳細を見る
[x] 人気ゲーム
[ ] ユーザープレイ数を獲得
[ ] 同期ユーザープレイ
[ ] ユーザーコレクションを取得
[ ] ユーザーコレクションを同期
[ ] 類似ゲームを入手

前提条件

Node.js 22.5.0 以上（実験的な SQLite サポートに必要）
npm（依存関係管理用）

構築と実行

サーバーを構築するには:

# Install dependencies
npm install

# Build the TypeScript code
npm run build

サーバーを直接実行するには:

# The --experimental-sqlite flag is required
node --experimental-sqlite build/index.js

Docker で実行するには:

# Build the Docker image
docker build -t bgg-mcp-server .

# Run the container
docker run --rm -i bgg-mcp-server

テスト

サーバーが正しく動作していることを確認するには:

# Make sure the server is built first
npm run build

# Run the test script with the experimental SQLite flag
node --experimental-sqlite test-mcp.js

テストスクリプトは次の処理を実行します。

MCPサーバーを起動する
検索ゲーム機能をテストする
ホットゲーム機能をテストする
結果とエラーを表示する

Claude for Desktop と併用

Claude for Desktop の構成ファイルを開きます。
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
直接 Node.js 実行用のサーバー構成を追加します。

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

または 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 "$(pwd)/data:/app/data"オプションは、ローカルdataディレクトリを Docker コンテナ内の/app/dataディレクトリにマウントし、SQLite データベースがコンテナ外部に永続化されることを保証します。

デスクトップ版のClaudeを再起動する

例題

Claude に接続すると、次のような質問をすることができます。

「Boardgamegeekで人気の新しいゲームは何ですか？」
「boardgamegeekでMolly Houseというゲームを検索してください」

データストレージ

サーバーはデータの永続化にSQLiteを使用しています。取得したゲームデータ、ユーザーコレクション、プレイ履歴はすべてdata/bgg.sqliteデータベースファイルに保存されます。これは以下のようになります。

BoardGameGeekへのAPI呼び出しを削減
繰り返しのクエリに対する応答時間を改善
サーバーの再起動間でデータを維持する

データベースが存在しない場合は自動的に作成され、サーバーの使用時にデータが入力されます。

BoardGameGeek MCP Server

Integrations