BoardGameGeek MCP 服务器

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

功能

此服务器提供以下工具：

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

前提条件

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

构建和运行

构建服务器：

# 安装依赖
npm install

# 构建 TypeScript 代码
npm run build

直接运行服务器：

# 需要 --experimental-sqlite 标志
node --experimental-sqlite build/index.js

使用 Docker 运行：

# 构建 Docker 镜像
docker build -t bgg-mcp-server .

# 运行容器
docker run --rm -i bgg-mcp-server

测试

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

# 确保首先构建服务器
npm run build

# 运行测试脚本
node test-direct.js

测试脚本将：

1. 启动 MCP 服务器
2. 测试 search-games 功能
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：

{
  "mcpServers": {
    "boardgamegeek": {
      "command": "node",
      "args": ["--experimental-sqlite", "/path/to/bgg-mcp-server/build/index.js"]
    }
  }
}

3. 或者使用 Docker (推荐):

{
  "mcpServers": {
    "boardgamegeek": {
      "command": "bash",
      "args": ["-c", "cd /path/to/bgg-mcp-server && docker build -t bgg-mcp-server . && docker run --rm -i bgg-mcp-server"]
    }
  }
}

4. 重启 Claude for Desktop

示例问题

连接到 Claude 后，您可以提出如下问题：

• "查找与 Pandemic 类似的桌游"
• "BoardGameGeek 上目前最热门的 10 款游戏是什么？"
• "显示 Catan 的详细信息"
• "用户 'TomVasel' 的收藏中有哪些游戏？"
• "用户 'dice_tower' 最近玩了哪些游戏？"
• "查找与 Catan 类似的游戏"
• "从 BGG 用户名 'example' 同步我的收藏"

数据存储

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

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

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