Bgg MCP Server

🚀 BoardGameGeek MCP 服務器

這是一個集成了 BoardGameGeek XML API 的模型上下文協議 (MCP) 服務器。它為 Claude 提供了強大的功能，使其能夠搜索桌遊、獲取遊戲詳細信息、檢索用戶收藏等。

🚀 快速開始

本服務器允許您藉助 BoardGameGeek XML API 實現多種桌遊相關功能。您可以按如下步驟構建並運行服務器：

構建服務器

# 安裝依賴項
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

✨ 主要特性

此服務器提供了豐富的工具，具體如下：

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（用於依賴管理）

💻 使用示例

配置示例

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

命令示例

# 構建項目
npm install && npm run build

# 運行測試腳本
node --experimental-sqlite test-mcp.js

# 使用 Docker 運行
docker build -t bgg-mcp-server . && docker run --rm -i bgg-mcp-server

📚 詳細文檔

測試

要驗證服務器是否正常運行，可按以下步驟操作：

# 確保服務器已構建
npm run build

# 使用實驗性 SQLite 標誌運行測試腳本
node --experimental-sqlite test-mcp.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 -v \"$(pwd)/data:/app/data\" bgg-mcp-server"]
    }
  }
}

注意：-v 標誌用於掛載數據目錄，確保數據持久化。 4. 重啟或重新加載 Claude 應用程序以應用配置。

⚠️ 注意事項

⚠️ 重要提示

• 確保 Node.js 和 npm 已正確安裝。
• 在使用 Docker 時，可能需要調整掛載路徑以確保數據持久化。
• 測試腳本可能會生成額外的日誌或輸出，請檢查控制檯以獲取更多信息。

通過以上步驟，您可以成功設置和運行 BoardGameGeek MCP 服務器，並與 Claude 集成。