BGG MCP

快速结论

BGG MCP 是由 kkjdaniel 独立维护的社区项目，不是 BoardGameGeek 官方服务器，也不代表 BoardGameGeek、BoardGamePrices 或 Recommend.Games。它用 Go 和 GoGeek 库把桌游搜索、详情、用户收藏、热门榜、用户资料、价格、交易匹配、相似推荐和论坛帖子接入 MCP 客户端。截至 2026-07-21，GitHub 最新稳定版是 v1.6.1，采用 MIT License，可通过 Docker 镜像或本地编译运行。

它适合桌游玩家、社群管理员和内容创作者在 Claude、Cursor 等客户端里做资料检索与收藏分析。当前 README 列出 9 个稳定核心工具和 1 个实验工具。实验性的 bgg-rules 会搜索 BGG 论坛回答规则问题，不应与正式规则书、勘误或出版商裁定等同。多数 BGG 数据调用需要申请 BGG API Key；价格数据则来自 BoardGamePrices.co.uk，而不是 BoardGameGeek API 自身，覆盖地区、零售商、库存、税费和更新时间都可能不同。

核心功能

• bgg-search：按名称搜索桌游，并区分基础游戏、扩展或全部类型。
• bgg-details：按 BGG ID 获取游戏详情、评分和相关元数据；社区字段和评分会变化。
• bgg-collection：查询并筛选某个用户公开收藏，可按评分、游玩状态等条件缩小结果。
• bgg-hot 与 bgg-user：读取热门榜和用户公开资料；热门不代表长期评价或购买建议。
• bgg-price：按 BGG ID 请求多零售商价格，但上游是 BoardGamePrices.co.uk，不是 BGG 商店或官方报价。
• bgg-trade-finder：比较两个用户的收藏与交易意愿，生成可能的交换机会，最终仍需双方确认版本、品相、地区和运费。
• bgg-recommender：通过 Recommend.Games 提供相似游戏候选，其算法和可用性不属于 BGG MCP 自身控制范围。
• bgg-thread-details：读取指定论坛主题及帖子，长主题可能占用大量模型上下文，也可能包含过时或互相矛盾的回复。
• 实验性 bgg-rules：搜索论坛中的规则讨论与澄清，仅适合定位线索；应回到规则书、官方 FAQ、勘误和设计师裁定复核。

适合人群

• 想用自然语言搜索 BGG、查看桌游详情和热门趋势的桌游玩家。
• 需要整理个人或公开收藏、发现未玩游戏、比较用户交易清单的社群成员。
• 制作选购指南、播客、视频或社群帖，需要快速找到候选资料但会人工核对来源的内容创作者。
• 能自行管理 Docker 或 Go 二进制、环境变量、API Key 和 MCP 客户端配置的技术用户。
• 不适合需要官方 BoardGameGeek 支持、保证实时全球售价、自动下单，或把论坛回答当成正式规则裁定的用户。

使用场景

个人使用时，可以设置 BGG_USERNAME，让“我的收藏”映射到指定用户名，再用 bgg-collection 筛选未玩、高评分或适合某人数的游戏。交易场景可让 bgg-trade-finder 找到候选，但模型无法确认具体版本、语言、缺件、磨损、地区限制与运费，发送交易提议前要由双方逐项确认。

选购研究可以先用 bgg-search 找到正确 BGG ID，再调用详情、推荐与价格工具。不要仅凭相同名称匹配游戏，也不要把扩展误当基础游戏。价格结果必须标明查询时间、币种、国家或地区、零售商和是否含税运；BoardGamePrices 的链接、库存或价格可能延迟，结账页才是交易依据。规则问题则应把 bgg-rules 返回内容视为论坛检索摘要，随后检查对应版本的规则书、官方 FAQ 和勘误。

价格与版本

BGG MCP v1.6.1 本身免费，仓库使用 MIT License，允许在保留版权与许可证声明的条件下使用、修改和分发。免费软件仍有运行成本：Docker 或主机、网络、MCP 客户端、日志与升级都由使用者承担。仓库还发布 kdaniel/bgg-mcp Docker 镜像，v1.6.1 Release 的主要特性是 Universal Docker Image。

大多数工具需要 BoardGameGeek API 认证。推荐使用 BGG_API_KEY，可通过 BGG 的 API application form 申请；也支持 BGG_COOKIE，两者同时存在时优先 API Key。Cookie 可能包含账号会话信息，风险高于专用 Key，不应写入仓库、聊天记录或共享配置。BGG_USERNAME 是可选项，只用于支持“我/我的”快捷引用。BoardGameGeek 对 API 的准入、限流和使用条款独立于该 MIT 仓库，部署前仍需遵守上游规则。

国内访问与使用体验

needsVPN: false 表示没有把它归类为必须依赖特定海外访问条件的产品，但 GitHub、Docker Hub、BoardGameGeek、BoardGamePrices 和 Recommend.Games 的实际可达性与延迟仍会随网络环境变化。自托管只能控制 MCP 进程，不能消除这些外部 API 依赖。首次使用建议先验证 BGG Key、搜索、详情、收藏和热门榜，再决定是否开放价格、论坛和实验规则工具。

BGG 公开数据以英文为主，游戏名、版本、论坛术语和规则讨论可能混合多种语言。模型翻译不能消除版本差异。对中文社群发布内容时，保留英文原名、BGG ID、来源链接和查询日期，避免把民间译名映射到错误条目。日志不要保存 Cookie、API Key 或完整私人会话；即使收藏本身公开，也应尊重用户名关联和社群隐私。

优点

• 九个稳定工具覆盖搜索、详情、收藏、热门、用户、价格、交易、推荐与论坛，桌游工作流集中。
• Go 单二进制与 Docker 镜像让本地 MCP 部署相对直接。
• MIT License 权利边界清晰，便于审查、修改与内部集成。
• BGG_USERNAME 支持“我的收藏”等自然表达，减少重复输入用户名。
• 将 BoardGamePrices 与 Recommend.Games 接入同一工具集，适合生成候选清单。

不足

• 它是独立社区集成，不是 BoardGameGeek 官方产品，维护连续性和兼容修复依赖项目作者与贡献者。
• 大多数功能需要 BGG API Key，且受 BoardGameGeek API 可用性、准入与限流影响。
• bgg-price 的价格来自 BoardGamePrices，覆盖和时效不能代表所有商家或最终成交价。
• 推荐功能依赖 Recommend.Games；上游算法、服务变化和偏差不由本项目控制。
• 实验性 bgg-rules 检索论坛而非权威规则库，模型可能合并不同版本或错误帖子。
• 论坛全文和大型收藏会增加响应时间与 token 消耗，需要限制查询范围。

替代品对比

常见问题 FAQ

BGG MCP 是 BoardGameGeek 官方项目吗？

不是。它是 kkjdaniel 维护的独立社区集成。BoardGameGeek 提供上游数据与 API 准入，但不应被描述为该服务器的开发者、运营者或背书方。

当前稳定版和许可证是什么？

截至 2026-07-21，GitHub 最新稳定 Release 是 v1.6.1，仓库采用 MIT License。使用或分发时仍要保留许可证声明，并分别遵守 BGG 与其他上游服务条款。

共有多少工具？

当前 README 列出 9 个稳定核心工具，另有 1 个实验性 bgg-rules。实验标签意味着它不应享有与稳定工具相同的可靠性预期。

为什么需要 BGG API Key？

GoGeek v2 通过认证提高访问 BGG API 的可靠性。推荐申请并设置 BGG_API_KEY；Cookie 认证虽可用，但包含更敏感的会话信息，通常不应作为首选。

价格是 BoardGameGeek 官方价格吗？

不是。bgg-price 使用 BoardGamePrices.co.uk 的多零售商数据。结果受地区、币种、商家覆盖、库存和刷新时间影响，应回到商家结账页确认。

bgg-rules 能代替规则书吗？

不能。它搜索 BGG 论坛讨论，适合发现相关帖子。正式判断应核对对应语言与版本的规则书、官方 FAQ、勘误及出版商或设计师明确裁定。

总结

BGG MCP v1.6.1 是覆盖面较完整的社区桌游 MCP：九个稳定工具足以完成搜索、收藏、交易候选和资料研究，实验规则工具则适合辅助定位论坛线索。采用前应先申请专用 BGG Key，用 Docker 在本地验证少量查询，并明确三个外部边界：BoardGameGeek 提供核心数据，BoardGamePrices 提供价格，Recommend.Games 提供推荐。只要保留来源、版本、时间和人工核对，它会是实用的桌游研究接口；若需要官方支持、实时成交保证或权威规则裁定，则应直接使用对应官方与商家来源。