项目介绍
BGG MCP 通过 模型上下文协议，提供了对 BoardGameGeek API 的访问，支持检索和过滤棋盘游戏数据、用户收藏和资料。该服务器使用 Go 编写，并利用了 GoGeek 库，确保了强大的 API 交互。
价格数据由 BoardGamePrices.co.uk 提供，提供来自多个零售商的实时定价。
游戏推荐由 Recommend.Games 提供，基于 BoardGameGeek 数据提供算法相似性推荐。
<a href="https://boardgamegeek.com/"> <img src="images/powered-bgg.webp" width="160" alt="由 BGG 提供"> </a>演示
<div align="center">
工具
核心工具
| 工具 | 描述 |
|---|---|
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 热度 | bgg://hotness | 当前 BGG 热度列表，始终可用 |
我的 BGG 收藏 | bgg://my-collection | 您的个人 BGG 收藏（需要设置 BGG_USERNAME） |
资源使 AI 助手能够直接访问 BGG 数据，无需显式调用工具，使得对话更加自然高效。
提示
- 交易销售帖子 - 生成格式化的销售帖子，用于您的 BGG '待交易' 收藏，带有折扣市场价
- 游戏推荐 - 根据您的 BGG 收藏和偏好获得个性化游戏推荐
示例提示
这里是一些您可以用来与 BGG MCP 工具互动的示例提示：
🔍 搜索
"在 BGG 上搜索 Wingspan"
"Grand Austria Hotel 有多少个扩展？"
"仅搜索 Wingspan 扩展"
📊 游戏详情
"获取 Azul 的详情"
"显示游戏 ID 224517 的信息"
"Gloomhaven 的 BGG 评分是多少？"
📚 收藏
"显示 ZeeGarcia 的游戏收藏"
"显示 kkjdaniel 收藏中评分 9+ 的游戏"
"列出 rahdo 收藏中的未玩过的游戏"
"找到 kkjdaniel 收藏中适合 6 人的游戏"
"显示我收藏中评分 3 及以下的所有游戏"
"我的收藏中有哪些游戏是 rahdo 想要的？"
"kkjdaniel 有哪些是我想要的游戏？"
🔥 热度
"显示当前 BGG 热度列表"
"BGG 上正在流行什么？"
👤 用户资料
"显示 BGG 用户 rahdo 的详细信息"
"用户 ZeeGarcia 是何时加入 BGG 的？"
"我在 BGG 上有多少好友？"
💰 价格
"获取 Wingspan 在英镑中的最佳价格"
"显示 Ark Nova 在英国的最佳价格"
"比较 Wingspan 和 Ark Nova 的价格"
🎯 推荐
"推荐类似 Wingspan 的游戏"
"有哪些游戏类似于 Azul 并且至少有 1000 条评分？"
"找到 5 个类似 Troyes 的游戏"
📖 规则（实验性）
"[关于任何棋盘游戏的规则问题] - 使用 bgg-rules"
"[游戏机制] 在 [游戏名称] 中是如何工作的？使用 bgg-rules"
"我可以 [具体操作] 在 [游戏名称] 中吗？使用 bgg-rules"
"当 [情况] 发生时，在 [游戏名称] 中会发生什么？使用 bgg-rules"
注意：在您的问题中包含 "使用 bgg-rules" 以确保 AI 搜索 BGG 论坛以获取答案。
安装
需要认证：大多数 BGG MCP 工具需要认证才能访问 BoardGameGeek 的 API。请参阅下面的 配置部分 了解设置说明。
您有多种安装 BGG MCP 的选择：
A) 通过 Smithery 安装（推荐）
使用 Smithery 在一分钟内开始：
- 在 Smithery 注册并选择您的客户端（例如，Claude Desktop）
- 点击配置 设置您的 BGG 认证（参见 配置）
- 连接 并立即开始使用 BGG 工具
或通过 Claude 用户的连接器
作为自定义连接器添加 BGG MCP：
- 前往 设置 → 连接器 → 添加自定义连接器
- 输入此 URL：
https://server.smithery.ai/@kkjdaniel/bgg-mcp/mcp - 点击 连接 授权
就这样！该服务器使用最新的可流传输 HTTP 传输。
提示：在 Claude Desktop 上添加的连接器也会出现在移动设备上并正常工作！
B) MCP 注册表
通过 MCP 注册表安装：
mcp install io.github.kkjdaniel/bgg-mcp
C) 手动设置
1. 安装 Go
您需要在系统上安装 Go 来构建二进制文件。这可以轻松地 下载和设置，或者您可以使用您喜欢的包管理器，如 Homebrew。
2. 构建
项目包含一个 Makefile 来简化构建和管理二进制文件。
# 构建应用程序（输出到 build/bgg-mcp）
make build
# 清理构建工件
make clean
# 同时清理和构建
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 v2.0+ 使用 GoGeek v2.0 库，需要认证才能可靠地访问 BoardGameGeek 的 API。
您可以使用 任一 BGG_API_KEY（推荐）或 BGG_COOKIE 进行配置：
对于 Smithery 用户
通过 Smithery 连接时，您可以在连接界面直接配置认证：
- 在 BGG MCP 服务器页面点击 配置 按钮
- 填写配置表单（在可选部分下）：
- BGG API 密钥（推荐） - 在 boardgamegeek.com/applications 获取
- BGG Cookie（替代方案） - 如果不使用 API 密钥
- BGG 用户名 - 您的用户名，用于个性化功能
- 点击 保存配置，然后使用此配置文件连接
您的设置会安全存储并在您使用 BGG MCP 工具时自动应用。
对于手动设置
选项 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_USERNAME 环境变量，以启用查询中的 "我" 和 "我的" 引用：
"bgg": {
"env": {
"BGG_USERNAME": "your_bgg_username",
"BGG_API_KEY": "your_api_key_here"
}
}
这将启用：
- 收藏查询："显示我的收藏" 而不是指定您的用户名
- 用户查询："显示我的 BGG 资料"
- AI 辅助：AI 可以自动使用您的用户名进行比较和分析
注意：如果您在没有设置 BGG_USERNAME 的情况下使用自我引用（我，我的，我），您将收到明确的错误消息。