BGG MCP: Сервер MCP для BoardGameGeek

BGG MCP предоставляет доступ к API BoardGameGeek через Model Context Protocol, позволяя получать и фильтровать данные о настольных играх, коллекциях пользователей и профилях. Сервер реализован на Go с использованием библиотеки GoGeek, которая помогает обеспечить надёжное взаимодействие с API.

Данные о ценах предоставляются BoardGamePrices.co.uk, предлагающим актуальные цены от множества розничных продавцов.

Рекомендации по играм обеспечиваются Recommend.Games, который предоставляет алгоритмические рекомендации на основе сходства с данными BoardGameGeek.

Демонстрация

▶️ Смотреть демонстрационное видео инструмента Rules Tool

Инструменты

Основные инструменты

🧪 Экспериментальные инструменты

Ресурсы

BGG MCP предоставляет ресурсы, к которым ИИ-ассистенты могут обращаться напрямую для получения контекстной информации:

Промпты

BGG MCP включает предварительно настроенные промпты для часто используемых рабочих процессов:

| Промпт | Описание | | Объявление о продаже | Создайте форматированное объявление о продаже для вашей коллекции игр "на обмен" на BGG с ценами ниже рыночных | | Рекомендации игр | Получите персонализированные рекомендации игр на основе вашей коллекции на BGG и предпочтений |

Примеры запросов

Вот несколько примеров запросов, которые можно использовать для взаимодействия с инструментами BGG MCP:

🔍 Поиск

"Search for Wingspan on BGG"
"How many expansions does Grand Austria Hotel have?"
"Search for Wingspan expansions only"

📊 Детали игры

"Get details for Azul"
"Show me information about game ID 224517"
"What's the BGG rating for Gloomhaven?"

📚 Коллекция

"Show me ZeeGarcia's game collection"
"Show games rated 9+ in kkjdaniel's collection"
"List unplayed games in rahdo's collection"
"Find games for 6 players in kkjdaniel's collection"
"Show me all the games rated 3 and below in my collection"
"What games in my collection does rahdo want?"
"What games does kkjdaniel have that I want?"

🔥 Популярное

"Show me the current BGG hotness list"
"What's trending on BGG?"

👤 Профиль пользователя

"Show me details about BGG user rahdo"
"When did user ZeeGarcia join BGG?"
"How many buddies do I have on bgg?"

💰 Цены

"Get the best price for Wingspan in GBP"
"Show me the best UK price for Ark Nova"
"Compare prices for: Wingspan & Ark Nova"

🎯 Рекомендации

"Recommend games similar to Wingspan"
"What games are like Azul but with at least 1000 ratings?"
"Find 5 games similar to Troyes"

📖 Правила (Экспериментально)

"[Your rules question about any board game] - use bgg-rules"
"How does [game mechanic] work in [game name]? use bgg-rules"
"Can I [specific action] in [game name]? use bgg-rules"
"What happens when [situation] in [game name]? use bgg-rules"

Примечание: Включите фразу "use bgg-rules" в ваш вопрос, чтобы ИИ искал ответы на форумах BGG.

Установка

Требуется аутентификация: Большинство инструментов BGG MCP требуют аутентификации для доступа к API BoardGameGeek. Инструкции по настройке см. в разделе Конфигурация ниже.

A) Docker (Рекомендуется)

BGG MCP опубликован на Docker Hub и указан в реестре MCP. Добавьте следующее в ваш файл claude_desktop_config.json (Claude Desktop) или settings.json (VS Code / Cursor):

"bgg": {
    "command": "docker",
    "args": ["run", "-i", "--rm",
        "-e", "BGG_API_KEY",
        "-e", "BGG_USERNAME",
        "kdaniel/bgg-mcp"
    ],
    "env": {
        "BGG_API_KEY": "your_api_key_here",
        "BGG_USERNAME": "your_bgg_username"
    }
}

Подробности о получении ключа API BGG и настройке имени пользователя см. в разделе Конфигурация ниже.

Для получения дополнительной информации о подключении серверов MCP к вашему клиенту ознакомьтесь с официальным руководством по MCP.

B) Ручная установка

1. Установите Go

Для сборки бинарного файла вам потребуется установить Go на вашу систему. Это можно легко сделать здесь, или вы можете использовать предпочитаемый вами менеджер пакетов, например Brew.

2. Сборка

В проекте есть Makefile для упрощения сборки и управления бинарным файлом.

# Build the application (output goes to build/bgg-mcp)
make build

# Clean build artifacts
make clean

# Both clean and build
make all

Или вы можете просто собрать его напрямую с помощью Go...

go build -o build/bgg-mcp

3. Добавьте конфигурацию MCP

В файл settings.json (VS Code / Cursor) или claude_desktop_config.json добавьте следующее в список серверов, указав путь к созданному ранее бинарному файлу. После загрузки вашего ИИ-инструмента вы увидите инструменты, предоставляемые подключённым сервером:

"bgg": {
    "command": "path/to/build/bgg-mcp",
    "args": ["-mode", "stdio"]
}

Дополнительные сведения о настройке Claude можно найти здесь.

Конфигурация

Аутентификация

BGG MCP использует библиотеку GoGeek v3, которая требует аутентификации для доступа к API BoardGameGeek.

Вы можете настроить аутентификацию, используя либо BGG_API_KEY (рекомендуется), либо BGG_COOKIE:

Настройка аутентификации

Вариант 1: Ключ API (Рекомендуется)

Получите ключ API через форму заявки на API BoardGameGeek и добавьте его в конфигурацию:

"bgg": {
    "env": {
        "BGG_API_KEY": "your_api_key_here"
    }
}

Вариант 2: Аутентификация через Cookie

Альтернативно вы можете использовать аутентификацию на основе cookie:

"bgg": {
    "env": {
        "BGG_COOKIE": "bggusername=user; bggpassword=pass; SessionID=xyz"
    }
}

Примечание: Если указаны оба варианта, по умолчанию будет использоваться BGG_API_KEY.

Настройка имени пользователя

Вы можете дополнительно задать переменную окружения BGG_USERNAME, чтобы использовать ссылки "мне", "мой" и т.д. в запросах без явного указания имени пользователя:

"bgg": {
    "env": {
        "BGG_USERNAME": "your_bgg_username",
        "BGG_API_KEY": "your_api_key_here"
    }
}

Это позволяет:

• Запросы коллекции: "Покажи мою коллекцию" вместо указания имени пользователя
• Запросы пользователя: "Покажи мой профиль на BGG"
• Помощь ИИ: ИИ сможет автоматически использовать ваше имя пользователя для сравнений и анализа

Примечание: Если вы используете самоотсылки (мне, мой, я) без установки BGG_USERNAME, вы получите понятное сообщение об ошибке.