← 返回目录
B

BoardGameGeek MCP Server

社区
通过 Model Context Protocol 访问 BoardGameGeek 数据
GitHub 源仓库 ↗
★ 52 Stars 分类 · 其他 热门 源版本 1a52a319e8cc
52FMRS · D
可靠性
8/20
安全与权限
10/20
维护活跃度
10/20
文档质量
12/20
安装易用性
12/20

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

查看 FMRS 评分方法 →

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

工具能力

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 论坛来回答规则问题(实验性工具)

安装接入

推荐使用 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"
    }
  }
}

选型与风险

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

常见排障

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

使用场景

查询棋盘游戏信息和评分
管理用户的 BGG 收藏列表
获取 BGG 热门游戏列表
比较不同零售商的价格
查找相似游戏推荐
生成交易的销售帖子

支持客户端

Claude Desktop完整支持