BoardGameGeek MCP Server

BoardGameGeek MCP 服务器

这是一个与 BoardGameGeek XML API 集成的模型上下文协议 (MCP) 服务器，允许 Claude 搜索棋盘游戏、检索游戏详细信息、获取用户收藏等。

特征

该服务器提供以下工具：

1. search-games ：按名称搜索棋盘游戏
2. get-game-details ：获取有关特定棋盘游戏的详细信息
3. get-hot-games ：获取 BoardGameGeek 上当前最热门的棋盘游戏
4. get-user-collection ：获取用户的棋盘游戏收藏，并提供过滤选项
5. sync-user-collection ：从 BoardGameGeek 同步用户的收藏
6. get-user-plays ：获取用户最近的棋盘游戏玩法
7. sync-user-plays ：从 BoardGameGeek 同步用户的游戏
8. get-similar-games ：获取与指定游戏类似的游戏

功能清单

• [x] 搜索
• [x] 获取游戏详情
• [x] 热门游戏
• [ ] 获取用户播放次数
• [ ] 同步用户播放
• [ ] 获取用户集合
• [ ] 同步用户集合
• [ ] 获取类似游戏

先决条件

• Node.js 22.5.0 或更高版本（实验性 SQLite 支持所需）
• npm（用于依赖管理）

构建和运行

构建服务器：

直接运行服务器：

要使用 Docker 运行：

测试

要验证服务器是否正常工作：

测试脚本将：

1. 启动 MCP 服务器
2. 测试搜索游戏功能
3. 测试 get-hot-games 功能
4. 显示结果和任何错误

与 Claude for Desktop 一起使用

1. 打开您的 Claude for Desktop 配置文件：
   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json
2. 添加服务器配置以直接执行 Node.js：

3. 或者使用 Docker（推荐）：

注意： -v "$(pwd)/data:/app/data"选项将本地data目录挂载到Docker容器中的/app/data目录，确保SQLite数据库在容器外持久化。

4. 重启 Claude 桌面版

示例问题

与 Claude 建立联系后，您可以提出以下问题：

• Boardgamegeek 上有哪些热门游戏？
• “在 boardgamegeek 上查找游戏 Molly House”

数据存储

服务器使用 SQLite 进行数据持久化。所有检索到的游戏数据、用户收藏和游戏历史记录都存储在data/bgg.sqlite数据库文件中。该文件：

• 减少对 BoardGameGeek 的 API 调用
• 缩短重复查询的响应时间
• 在服务器重启期间维护数据

如果数据库不存在，则会自动创建数据库，并在您使用服务器时填充。