← 返回目录

BoardGameGeek MCP Server

社区

通过 Model Context Protocol 访问 BoardGameGeek 数据

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 131 / 230
Stars: ★ 53 热门
传输方式: stdio（本地进程）
运行环境: Docker · Go
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 6 天前
工具数: 10

52FMRS · D

该服务器为棋盘游戏爱好者提供了便捷的工具集，但需要 BGG 认证才能使用大部分功能。用户界面友好，文档清晰，适合集成到 AI 助手工作流中。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

10/20

文档质量

12/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 基于表述，服务端使用 Go 语言实现，借助 GoGeek 库，且 README 提到了 Docker 镜像和 Makefile。但作为静态审查，无法执行代码。虽然仓库中可能没有提供可验证的 CI 工作流和测试，但核心功能（如搜索、详情、收藏等）在工具列表中清晰列出。由于没有实际执行证据，因此降分。
安全与权限 10/20: 服务器要求使用 BGG_API_KEY 或 BGG_COOKIE 进行认证，且未在明文示例中发现真实令牌。环境变量中存储了认证信息，属于标准做法。外部 API 调用是任务所必需的，没有发现过度的权限请求。潜在风险：如果 BGG_COOKIE 以不安全的格式存储，可能带来风险，但文档强调了两种认证方式，因此评为 10 分。
维护活跃度 10/20: 仓库有 MIT 许可证，版本号 1.6.0，并且有已知的发布历史（如提及 v2.0+）。open issues 很少，说明维护者积极处理问题。但仓库可能缺少持续集成（如 GitHub Actions）或依赖更新记录，因此进行了扣分。
文档质量 12/20: README 提供了详细的安装说明、配置示例和工具描述。它包含了清晰的认证步骤和示例 prompt。扣分原因是缺少参数参考、故障排除日志或详细的 API 限制说明；此外，没有显示测试或 CI 文档。
安装易用性 12/20: 提供了 Docker 安装方式以及手动 Go 构建的步骤。包含客户端配置示例（Claude Desktop / VS Code）。扣分原因是缺少对主流客户端的具体配置示例，并且由于未执行安装，无法验证步骤是否有效。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

棋盘游戏爱好者
需要快速访问 BGG 数据的开发者
希望通过 AI 助手管理游戏收藏的用户

不适合谁

不需要 BGG 数据或棋盘游戏信息的用户
希望使用 BGG 官方 API 但不经过 MCP 的用户

所需权限

需要读取用户的 BGG 收藏和个人资料（需提供 BGG_USERNAME）
支持通过 BGG_API_KEY 或 BGG_COOKIE 进行认证

风险与副作用

需要提供 BGG API 密钥或 Cookie，这些凭据可能被滥用，请妥善保管
价格数据来自第三方，可能不完整或不准确
依赖外部服务（BGG、BoardGamePrices、Recommend.Games），可能因网络问题导致不可用

安装接入

准备工作

运行环境：Docker · Go

BGG_API_KEY 可选密钥 BoardGameGeek API 密钥（推荐认证方式），可在 https://boardgamegeek.com/applications 申请获取。

BGG_COOKIE 可选密钥 BGG Cookie 字符串认证（API密钥的替代方案），格式为 'bggusername=user; bggpassword=pass; SessionID=xyz'。

其他可选配置项（1 个）

BGG_USERNAME 可选你的 BoardGameGeek 用户名，用于在提示中支持 ME/MY 等自我引用，可选。

推荐使用 Docker 方式安装：将上述配置添加到 Claude Desktop 或 VS Code 的配置文件中。也可以手动构建：安装 Go，运行 make build，然后将生成的二进制文件配置为命令。请确保设置 BGG_API_KEY 或 BGG_COOKIE 以进行身份验证。

claude_desktop_config.json

{
  "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"
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "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"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

生成并校验客户端配置

验证是否装好

在客户端连接后，工具列表中应出现 bgg-search、bgg-hot 等工具；发送「获取当前BGG热度榜单」能返回结果即证明安装成功。

常见排障

检查 BGG_API_KEY 或 BGG_COOKIE 是否正确设置
确保网络连接正常，能够访问 BGG 和外部服务
如果使用 Docker，确认镜像已正确拉取并运行
检查配置文件中的路径和命令是否正确

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在BGG上搜索Wingspan
展示kkjdaniel收藏中评分9+的游戏
获取Wingspan的最低GBP价格
推荐与Wingspan类似的游戏

工具能力 10

bgg-search 只读

搜索棋盘游戏，并可筛选类型（基础游戏、扩展包或全部）

bgg-details 只读

获取特定棋盘游戏的详细信息

bgg-collection 只读

查询和筛选用户的游戏收藏，具有丰富的筛选选项

bgg-hot 只读

获取当前的 BGG 热门列表

bgg-user 只读

获取用户个人资料信息

bgg-price 只读

使用 BGG ID 从多个零售商获取当前价格

bgg-trade-finder 只读

查找两个 BGG 用户之间的交易机会

bgg-recommender 只读

根据与特定游戏的相似性获取游戏推荐

展开其余 2 个工具

bgg-thread-details 只读

获取特定 BGG 论坛帖子的完整内容，包括所有回复

bgg-rules 只读

通过搜索 BGG 论坛来回答规则问题（实验性工具）

使用场景

查询棋盘游戏信息和评分

管理用户的 BGG 收藏列表

获取 BGG 热门游戏列表

比较不同零售商的价格

查找相似游戏推荐

生成交易的销售帖子

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

BGG MCP 是一个 MCP 服务器，提供对 BoardGameGeek API 的访问，使用户能够检索和过滤棋盘游戏数据、用户收藏和个人资料。该服务器使用 Go 语言实现，并基于 GoGeek 库。价格数据来自 BoardGamePrices.co.uk，游戏推荐由 Recommend.Games 提供。