BGG MCP: BoardGameGeek MCP Server
价格数据由提供 BoardGamePrices.co.uk，提供来自多家零售商的实时定价。
游戏推荐由 推荐。游戏，它基于BoardGameGeek数据提供算法相似性建议。
演示
工具
核心工具
| 工具 | 说明 |
|---|---|
bgg-search | 搜索带有类型过滤的棋盘游戏（基础游戏、扩展或全部） |
bgg-details | 获取特定棋盘游戏的详细信息 |
bgg-collection | 使用广泛的过滤选项查询和过滤用户的游戏收藏 |
bgg-hot | 获取当前BGG热门列表 |
bgg-user | 获取用户配置文件信息 |
bgg-price | 使用BGG ID从多个零售商处获取当前价格 |
bgg-trade-finder | 在两个BGG用户之间寻找交易机会 |
bgg-recommender | 根据与特定游戏的相似性获取游戏推荐 |
bgg-thread-details | 获取特定BGG论坛帖子的全部内容，包括所有帖子 |
🧪 实验工具
| 工具 | 说明 |
|---|---|
bgg-rules | 通过在BGG论坛上搜索相关讨论和澄清来回答规则问题 |
资源
BGG MCP公开了AI助手可以直接访问的资源，以获取上下文信息：
| 资源 | URI | 描述 |
|---|---|---|
BGG Hotness | bgg://hotness | 当前BGG热门列表，始终可用 |
My BGG Collection | bgg://my-collection | 您的个人BGG收藏（需要 BGG_USERNAME 待设置） |
提示
BGG MCP包括常见工作流的预配置提示：
| 提示 | 描述 |
|---|---|
Trade Sales Post | 为您的BGG“交易”收款生成一个格式化的销售帖子，其中包含折扣市场价格 |
Game Recommendations | 根据您的BGG收藏和偏好获得个性化游戏推荐 |
示例提示
以下是一些示例提示，您可以使用它们与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?"📚 收集
"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?"🔥 热度
"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"📖 规则（实验）
"[Your rules question about any board game] - use bgg-rules"
"How does [game mechanic] work in [game name]? use bgg-rules"
"Can I [specific action] in [game name]? use bgg-rules"
"What happens when [situation] in [game name]? use bgg-rules"注意：在您的问题中包含“使用bgg规则”，以确保AI在bgg论坛中搜索答案。
安装
需要认证：大多数BGG MCP工具需要身份验证才能访问BoardGameGeek的API。看 配置部分 下面是安装说明。
A） Docker（推荐）
BGG MCP发布于 并在 MCP注册表。将以下内容添加到您的 claude_desktop_config.json （克劳德桌面）或 settings.json （VS代码/光标）：
"bgg": {
"command": "docker",
"args": ["run", "-i", "--rm",
"-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密钥和设置用户名的详细信息。
有关将MCP服务器连接到客户端的更多详细信息，请参阅 MCP官方指南.
B） 手动设置
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-mcp3.添加MCP配置
在 settings.json （VS代码/光标）或 claude_desktop_config.json 将以下内容添加到您的服务器列表中，并将其指向您之前创建的二进制文件，加载AI工具后，您应该会看到连接的服务器提供的工具：
"bgg": {
"command": "path/to/build/bgg-mcp",
"args": ["-mode", "stdio"]
}有关配置Claude的更多详细信息，请访问 在这里找到.
配置
认证
BGG MCP v2.0+使用GoGeek v2.0库，该库需要身份验证才能可靠访问BoardGameGeek的API。
您可以使用配置身份验证 要么 BGG_API_KEY （推荐）或 BGG_COOKIE:
身份验证设置
选项1：API密钥（推荐）
从获取API密钥 BoardGameGeek的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_USERNAME 环境变量，用于在查询中启用“me”和“my”引用，而无需显式声明您的用户名：
"bgg": {
"env": {
"BGG_USERNAME": "your_bgg_username",
"BGG_API_KEY": "your_api_key_here"
}
}这使得：
- 收款查询：“显示我的收藏”而不是指定您的用户名
- 用户查询：“显示我的BGG个人资料”
- AI 助手：AI可以自动使用您的用户名进行比较和分析
备注：当您在不设置BGG_USERNAME的情况下使用自我引用（me、my、I）时，您将收到一条明确的错误消息。
