faceit-mcp

Un servidor MCP independiente que proporciona a Claude datos en tiempo real de CS2 FACEIT: estadísticas de jugadores, historial de partidas, comparaciones lado a lado, tabla de clasificación y tendencia de ELO.

Funciona con Claude Desktop y Claude Code. Archivo único, sin dependencias de framework más allá de mcp, aiohttp, aiosqlite y python-dotenv.

Demo

Tú: Compara a zywoo, NiKo y sh1ro lado a lado

Claude: Aquí tienes una comparación lado a lado de los tres jugadores:

	ZywOo	NiKo	sh1ro
ELO	4521	4218	4384
Nivel	10	10	10
K/D	1.43	1.38	1.41
HS%	52.1%	48.7%	44.2%
Tasa de victorias	61.3%	58.9%	60.1%
Promedio de bajas	24.8	23.6	23.1
K/R	0.91	0.87	0.89

Tú: ¿Cómo ha estado jugando NiKo en sus últimas 20 partidas?

Claude: Forma reciente de NiKo en 20 partidas:

• Registro: 13G – 7P (65.0% tasa de victorias)

• Promedio K/D: 1.42 | Promedio bajas: 24.3 | Promedio HS%: 49.1%

• Racha actual: 3G

Mejores mapas: de_inferno (8G-2P, 70% tv), de_ancient (4G-1P, 80% tv) Peor mapa: de_vertigo (1G-3P, 25% tv)

Related MCP server: Claude Stats MCP

Herramientas

Todas las herramientas excepto get_leaderboard y get_elo_trend funcionan para cualquier jugador público de FACEIT con solo una clave API. Las herramientas de tabla de clasificación y tendencia de ELO requieren una base de datos SQLite con usuarios registrados (ver Configuración de BD).

Requisitos

• Python 3.12+

• Clave API de datos de FACEIT (gratuita)

Configuración

1. Clonar e instalar dependencias

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

2. Establecer tu clave API

Crea un archivo .env junto al script:

FACEIT_API_KEY=your_key_here

O pásala como una variable de entorno directamente en la configuración a continuación.

Conectar a Claude Desktop

Añadir a 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" }
    }
  }
}

Ubicación del archivo de configuración:

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

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

Conectar a Claude Code

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

Luego establece FACEIT_API_KEY en el archivo .env junto al script.

Ejemplos de prompts

Una vez conectado, simplemente pregúntale a Claude de forma natural:

• "¿Cuáles son las estadísticas de por vida de s1mple?"

• "Muéstrame las últimas 10 partidas de NiKo"

• "Compara a zywoo, device y sh1ro lado a lado"

• "¿Cómo ha estado rindiendo NiKo en sus últimas 20 partidas?"

• "Muestra el marcador completo de la partida 1-abc123…"

• "¿En qué mapas rinde mejor sh1ro?"

• "Muestra la tabla de clasificación de nuestro grupo"

• "¿Cómo ha cambiado mi ELO durante el último mes?"

Tabla de clasificación y tendencia de ELO

get_leaderboard y get_elo_trend leen desde una base de datos SQLite local. Por defecto, la BD reside en ~/.faceit-mcp/data.db y se crea automáticamente al iniciar.

Para poblarla, apunta DB_PATH a una base de datos que tenga una tabla users:

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

Si utilizas el bot de Telegram de CS2 FACEIT complementario, establece DB_PATH a la base de datos del bot y estas herramientas reflejarán a tus usuarios registrados automáticamente.

Variables de entorno

Licencia

MIT