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] 热门游戏

• [ ] 获取用户播放次数

• [ ] 同步用户播放

• [ ] 获取用户集合

• [ ] 同步用户集合

• [ ] 获取类似游戏

Related MCP server: Claude AI Documentation Assistant

先决条件

• Node.js 22.5.0 或更高版本（实验性 SQLite 支持所需）

• npm（用于依赖管理）

构建和运行

构建服务器：

# Install dependencies
npm install

# Build the TypeScript code
npm run build

直接运行服务器：

# The --experimental-sqlite flag is required
node --experimental-sqlite build/index.js

要使用 Docker 运行：

# Build the Docker image
docker build -t bgg-mcp-server .

# Run the container
docker run --rm -i bgg-mcp-server

测试

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

# Make sure the server is built first
npm run build

# Run the test script with the experimental SQLite flag
node --experimental-sqlite test-mcp.js

测试脚本将：

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：

{
  "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 -v \"$(pwd)/data:/app/data\" bgg-mcp-server"]
    }
  }
}

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

4. 重启 Claude 桌面版

示例问题

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

• Boardgamegeek 上有哪些热门游戏？

• “在 boardgamegeek 上查找游戏 Molly House”

数据存储

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

• 减少对 BoardGameGeek 的 API 调用

• 缩短重复查询的响应时间

• 在服务器重启期间维护数据

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