BGG MCP: BoardGameGeek MCP API Server

AI アシスタントが BoardGameGeek にアクセスできる MCP サーバーです。ゲームの詳細、コレクション、価格、おすすめ、ルールに関する回答を利用できます。

BGG MCP は、Model Context Protocol を通じて BoardGameGeek API にアクセスし、ボードゲームのデータ、ユーザーのコレクション、プロフィールの取得や絞り込みを可能にします。サーバーは Go で実装されており、堅牢な API 通信を支援する GoGeek ライブラリを使用しています。

価格データは BoardGamePrices.co.uk が提供しており、複数の小売業者のリアルタイム価格を確認できます。

ゲームのおすすめは Recommend.Games が提供しており、BoardGameGeek のデータに基づくアルゴリズムで類似ゲームをおすすめします。

デモ

ツール

ツール	説明
bgg-search	種類（基本ゲーム、拡張セット、またはすべて）で絞り込んでボードゲームを検索します
bgg-details	最適なプレイ人数、ランキング、オプションのマーケットプレイス掲載情報、版、ユーザーコメントなど、ゲームの詳細を取得します
bgg-collection	ユーザーのコレクションを評価、BGG 評価、ランキング、プレイ回数で検索・絞り込みます
bgg-hot	現在の BGG 人気ランキングを取得します
bgg-user	ユーザープロフィール情報を取得します
bgg-price	BGG ID を使用して、複数の小売業者の現在の価格を取得します
bgg-trade-finder	2 人の BGG ユーザー間でトレードの機会を探します
bgg-recommender	特定のゲームとの類似性に基づいて、おすすめのゲームを取得します
bgg-rules	ゲームの BGG ルールフォーラムから最も関連性の高いスレッドを見つけて、ルールに関する質問に回答します
bgg-thread-details	特定の BGG フォーラムスレッドの全投稿を含む全文を取得します

メモ

結果には boardgamegeek.com の各ページへのリンクが含まれます。また、アシスタントには回答にそれらのリンクを含めるよう指示しています。

リソース

BGG MCP は、AI アシスタントがコンテキスト情報として直接アクセスできるリソースを公開します。

リソース	URI	説明
BGG Hotness	bgg://hotness	現在の BGG ホットネスリスト。常に利用できます
My BGG Collection	bgg://my-collection	個人用の BGG コレクション（BGG_USERNAME が設定されている場合のみ表示）
BGG User Collection	bgg://collection/{username}	任意の BGG ユーザーのコレクションにある所有ゲーム
BGG Game	bgg://game/{id}	BGG ID で指定したゲームの基本情報
BGG Forum Thread	bgg://thread/{id}	ID で指定した BGG フォーラムのスレッド。すべての投稿をプレーンテキストで表示

プロンプト

BGG MCP には、一般的なワークフロー向けに事前設定されたプロンプトが用意されています。

プロンプト	引数	説明
trade-sales-post	username、currency、destination、discount、platform	BGG の「for trade」コレクションにあるゲームについて、小売価格から割引した販売投稿を作成します
game-recommendations	username、currency、destination	BGG コレクションと好みに基づいて、パーソナライズされたゲームのおすすめを取得します
rules-question	game、question	ゲームの BGG ルールフォーラムから、ルールに関する質問に回答します

BGG_USERNAME が設定されている場合、どちらのプロンプトでも username は省略できます。

プロンプトの例

BGG MCP ツールを使う際に利用できるプロンプトの例を紹介します。

🔍 検索

"Search for Wingspan on BGG"
"How many expansions does Grand Austria Hotel have?"
"Search for Wingspan expansions only"

📊 ゲームの詳細

"Get details for Azul"
"Show me information about game ID 224517"
"What's the BGG rating for Gloomhaven?"
"What is Ark Nova selling for on the BGG marketplace?"
"What expansions does Wingspan have?"

📚 コレクション

"Show me ZeeGarcia's game collection"
"Show games rated 9+ in kkjdaniel's collection"
"List unplayed games in rahdo's collection"
"Find games for 6 players in kkjdaniel's collection"
"Show me all the games rated 3 and below in my collection"
"What games in my collection does rahdo want?"
"What games does kkjdaniel have that I want?"
"Which games in my collection play best at 2 players?"

🔥 ホットネス

"Show me the current BGG hotness list"
"What's trending on BGG?"

👤 ユーザープロフィール

"Show me details about BGG user rahdo"
"When did user ZeeGarcia join BGG?"
"How many buddies do I have on bgg?"

💰 価格

"Get the best price for Wingspan in GBP"
"Show me the best UK price for Ark Nova"
"Compare prices for: Wingspan & Ark Nova"

🎯 おすすめ

"Recommend games similar to Wingspan"
"What games are like Azul but with at least 1000 ratings?"
"Find 5 games similar to Troyes"

📖 ルール

ヒント

アシスタントは、ルールに関する質問に記憶を頼りに回答することがよくあります。ルールフォーラムが検索されるよう、BGG に言及し、ボードゲームについての質問だとはっきり伝えるか、rules-question プロンプトを使用してください。

"Check BGG, in Wingspan do pink powers trigger on my own turn?"
"What does the BGG rules forum say about trading with the bank during another player's turn in Catan?"
"In the board game Root, can the Vagabond attack a player it is allied with? Check BGG"
"Search BGG for how line of sight works in Gloomhaven"

インストール

認証が必要です：ほとんどの BGG MCP ツールで、BoardGameGeek の API にアクセスするには認証が必要です。設定手順については、以下の設定セクションをご覧ください。

A) Claude Desktop Extension（macOS / Windows）（推奨）

最新リリースから bgg-mcp.mcpb をダウンロードし、ダブルクリックしてください。Claude Desktop がインストールダイアログを開くので、BGG API キーとユーザー名を入力できます。Docker も Go も必要ありません。

B) Smithery（macOS / Windows）

BGG MCP は Smithery でも提供されています。同じバンドルが配布されるため、サーバーはお使いのマシン上でローカルに動作します。サーバーのページを開いてクライアントを選択し、表示されるインストール手順に従って、設定フォームに BGG API キーとユーザー名を入力してください。

C）Docker

BGG MCP は Docker Hub で公開されており、MCP Registry に掲載されています。claude_desktop_config.json（Claude Desktop）または settings.json（VS Code / Cursor）に次の内容を追加してください。

"bgg": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "--pull=always",
        "-e", "BGG_API_KEY",
        "-e", "BGG_USERNAME",
        "kdaniel/bgg-mcp"
    ],
    "env": {
        "BGG_API_KEY": "your_api_key_here",
        "BGG_USERNAME": "your_bgg_username"
    }
}

BGG API キーの取得方法とユーザー名の設定方法については、以下の設定をご覧ください。

--pull=always を指定すると、サーバーの起動時に毎回最新のイメージを取得するため、自動的に最新の状態を維持できます。サーバーをオフラインで起動する必要がある場合は、この指定を削除してください。

MCP サーバーをクライアントに接続する方法の詳細は、MCP 公式ガイドをご覧ください。

D）手動セットアップ

1. Go をインストールする

バイナリをビルドするには、システムに Go がインストールされている必要があります。こちらからダウンロードしてセットアップするか、Brew などのお好みのパッケージマネージャーを利用できます。

2. ビルドする

このプロジェクトには、バイナリのビルドと管理を簡単にする Makefile が含まれています。

# Build the application (output goes to build/bgg-mcp)
make build

# Clean build artifacts
make clean

# Both clean and build
make all

または、Go で直接ビルドすることもできます。

go build -o build/bgg-mcp

3. MCP の設定を追加する

settings.json（VS Code / Cursor）または claude_desktop_config.json にサーバーのリストとして次の内容を追加し、先ほど作成したバイナリを指定してください。AI ツールを起動すると、サーバーが提供するツールが接続されていることを確認できます。

"bgg": {
    "command": "path/to/build/bgg-mcp",
    "args": ["-mode", "stdio"]
}

Claude の設定の詳細はこちらをご覧ください。

設定

認証

BGG MCP は GoGeek v3 ライブラリを使用しており、BoardGameGeek の API にアクセスするには認証が必要です。

認証には、BGG_API_KEY（推奨）または BGG_COOKIE のいずれかを設定できます。

認証の設定

オプション 1：API キー（推奨）

BoardGameGeek の API 申請フォームから API キーを取得し、設定に追加してください。

"bgg": {
    "env": {
        "BGG_API_KEY": "your_api_key_here"
    }
}

オプション 2：Cookie 認証

代わりに、Cookie による認証も利用できます。

"bgg": {
    "env": {
        "BGG_COOKIE": "bggusername=user; bggpassword=pass; SessionID=xyz"
    }
}

注：両方を設定した場合、デフォルトでは BGG_API_KEY が使用されます。

ユーザー名の設定

BGG のユーザー名を任意で設定すると、クエリでユーザー名を明示しなくても、「me」や「my」といった参照を利用できます。

Claude Desktop Extensionをインストールした場合は、Claude Desktop の拡張機能設定（Settings > Extensions > BGG MCP）でユーザー名を入力してください。ここで API キーも設定できます。編集が必要な設定ファイルはありません。Smitheryからインストールした場合は、設定フォームで両方の入力を求められます。

Docker または手動セットアップの場合は、BGG_USERNAME 環境変数を設定してください。

"bgg": {
    "env": {
        "BGG_USERNAME": "your_bgg_username",
        "BGG_API_KEY": "your_api_key_here"
    }
}

これにより、次のことが可能になります。

• コレクションのクエリ：ユーザー名を指定せずに「自分のコレクションを表示して」と尋ねることができます
• ユーザーのクエリ：「自分の BGG プロフィールを表示して」と尋ねることができます
• AI による支援：AI が比較や分析にユーザー名を自動的に使用できます

注：ユーザー名を設定せずに自分自身を指す表現（me、my、I）を使うと、明確なエラーメッセージが表示されます。

更新通知

お使いのマシンで実行すると、BGG MCP は 1 日に 1 回 GitHub を確認し、新しいリリースがあるかどうかを調べます。新しいリリースがある場合、アシスタントはリリースへのリンクとともに、会話ごとに 1 回通知します。これを無効にするには、BGG_DISABLE_UPDATE_CHECK を true に設定してください。HTTP モードで実行している場合、サーバーは更新を確認しません。