faceit-mcp

Автономный сервер MCP, предоставляющий Claude актуальные данные CS2 FACEIT: статистику игроков, историю матчей, сравнение игроков, таблицу лидеров и динамику ELO.

Работает с Claude Desktop и Claude Code. Однофайловое решение, не требует зависимостей от фреймворков, кроме mcp, aiohttp, aiosqlite и python-dotenv.

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

Вы: Сравни zywoo, NiKo и sh1ro

Claude: Вот сравнение трех игроков:

	ZywOo	NiKo	sh1ro
ELO	4521	4218	4384
Уровень	10	10	10
K/D	1.43	1.38	1.41
HS%	52.1%	48.7%	44.2%
Винрейт	61.3%	58.9%	60.1%
Ср. убийств	24.8	23.6	23.1
K/R	0.91	0.87	0.89

Вы: Как NiKo сыграл в своих последних 20 матчах?

Claude: Недавняя форма NiKo за 20 матчей:

• Результат: 13П – 7П (винрейт 65.0%)

• Ср. K/D: 1.42 | Ср. убийств: 24.3 | Ср. HS%: 49.1%

• Текущая серия: 3 победы

Лучшие карты: de_inferno (8П-2П, 70% в/р), de_ancient (4П-1П, 80% в/р) Худшая карта: de_vertigo (1П-3П, 25% в/р)

Related MCP server: Claude Stats MCP

Инструменты

Все инструменты, кроме get_leaderboard и get_elo_trend, работают для любого публичного игрока FACEIT при наличии API-ключа. Инструменты таблицы лидеров и динамики ELO требуют базу данных SQLite с зарегистрированными пользователями (см. Настройка БД).

Требования

• Python 3.12+

• API-ключ FACEIT Data (бесплатно)

Установка

1. Клонируйте репозиторий и установите зависимости

git clone https://github.com/bluemadisonblue/faceit-mcp.git
cd faceit-mcp
pip install -r requirements.txt

2. Укажите свой API-ключ

Создайте файл .env рядом со скриптом:

FACEIT_API_KEY=your_key_here

Или передайте его как переменную окружения непосредственно в конфигурации ниже.

Подключение к Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "faceit-cs2": {
      "command": "python",
      "args": ["C:/full/path/to/faceit-mcp/faceit_mcp_server.py"],
      "env": { "FACEIT_API_KEY": "your_key_here" }
    }
  }
}

Расположение файла конфигурации:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Подключение к Claude Code

claude mcp add faceit-cs2 -- python /full/path/to/faceit-mcp/faceit_mcp_server.py

Затем установите FACEIT_API_KEY в файле .env рядом со скриптом.

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

После подключения просто спрашивайте Claude естественным языком:

• "Какая пожизненная статистика у s1mple?"

• "Покажи последние 10 матчей NiKo"

• "Сравни zywoo, device и sh1ro"

• "Как выступал NiKo в своих последних 20 матчах?"

• "Покажи полную таблицу результатов для матча 1-abc123…"

• "На каких картах sh1ro играет лучше всего?"

• "Покажи таблицу лидеров нашей группы"

• "Как изменился мой ELO за последний месяц?"

Таблица лидеров и динамика ELO

get_leaderboard и get_elo_trend считывают данные из локальной базы данных SQLite. По умолчанию БД находится по адресу ~/.faceit-mcp/data.db и создается автоматически при запуске.

Чтобы заполнить её, укажите DB_PATH для базы данных, содержащей таблицу users:

DB_PATH=/path/to/your/bot_data.db

Если вы используете сопутствующего Telegram-бота CS2 FACEIT, установите DB_PATH на базу данных бота, и эти инструменты будут автоматически отображать ваших зарегистрированных пользователей.

Переменные окружения

Лицензия

MIT