BoardGameGeek MCP 服务器

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

特征

该服务器提供以下工具：

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

功能清单

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

先决条件

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

测试脚本将：

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

与 Claude for Desktop 一起使用

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

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

或者使用 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数据库在容器外持久化。

重启 Claude 桌面版

示例问题

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

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

数据存储

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

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

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

BoardGameGeek MCP Server

Integrations