BGG MCP 是一个 MCP（Model Context Protocol）服务器，为 AI 助手提供对 BoardGameGeek 及其相关桌游数据的访问能力。通过该服务器，AI 助手可以检索和筛选桌游数据、用户收藏和个人资料。
主要能力
- 访问 BoardGameGeek API，获取桌游详情、用户收藏和用户资料。
- 提供价格数据，由 BoardGamePrices.co.uk 提供来自多个零售商的实时定价。
- 提供游戏推荐，由 Recommend.Games 基于 BoardGameGeek 数据提供算法相似度推荐。
- 结果会链接回 boardgamegeek.com 上的对应页面，并提示助手在回答中包含这些链接。
- 暴露资源供 AI 助手直接访问上下文信息。
- 包含针对常见工作流的预配置提示词。
使用方式
- 认证：大多数工具需要认证才能访问 BoardGameGeek API。可通过 BGG_API_KEY（推荐）或 BGG_COOKIE 配置。API 密钥需从 BoardGameGeek 的 API 申请表获取。若同时提供两者，默认使用 BGG_API_KEY。
- 用户名配置：可选设置 BGG_USERNAME 环境变量，以便在查询中使用“me”“my”等自指代。若未设置用户名却使用自指代，会收到明确的错误提示。
- 安装方式： A) Claude Desktop 扩展（macOS / Windows）：从最新 release 下载 bgg-mcp.mcpb 并双击，在安装对话框中输入 BGG API 密钥和用户名，无需 Docker 或 Go。 B) Docker：BGG MCP 已发布到 Docker Hub 并列入 MCP Registry。可将配置添加到 claude_desktop_config.json（Claude Desktop）或 settings.json（VS Code / Cursor）。使用 --pull=always 可在每次启动时获取最新镜像，如需离线启动可移除该参数。 C) 手动设置：需要安装 Go 来构建二进制文件。项目包含 Makefile 以简化构建和管理，也可直接用 Go 构建。然后在 settings.json 或 claude_desktop_config.json 的服务器列表中添加指向该二进制文件的配置。
- 更新通知：在本地运行时，BGG MCP 每天检查一次 GitHub 是否有新版本。若有，助手会在每次对话中提及一次并附上 release 链接。可设置 BGG_DISABLE_UPDATE_CHECK 为 true 关闭。HTTP 模式下服务器不会检查更新。
适用场景
- 向 AI 助手询问桌游推荐、收藏查询、用户资料、价格比较和规则问答。
- 示例提示词包括推荐类查询，以及通过提及 BGG 并明确指桌游来搜索规则论坛，或使用 rules-question 提示词。
限制
- 大多数工具需要认证，需获取 BGG API 密钥或使用 Cookie。
- 手动构建需要 Go 环境。
- 价格和推荐分别依赖第三方服务 BoardGamePrices.co.uk 和 Recommend.Games。
- 自指代查询需要预先设置 BGG_USERNAME。
