faceit-mcp

Ein eigenständiger MCP-Server, der Claude Live-CS2 FACEIT-Daten liefert — Spielerstatistiken, Spielverlauf, direkte Vergleiche, Bestenliste und ELO-Trend.

Funktioniert mit Claude Desktop und Claude Code. Einzeldatei, keine Framework-Abhängigkeiten außer mcp, aiohttp, aiosqlite und python-dotenv.

Demo

Du: Vergleiche zywoo, NiKo und sh1ro direkt miteinander

Claude: Hier ist ein direkter Vergleich der drei Spieler:

	ZywOo	NiKo	sh1ro
ELO	4521	4218	4384
Level	10	10	10
K/D	1.43	1.38	1.41
HS%	52.1%	48.7%	44.2%
Win Rate	61.3%	58.9%	60.1%
Avg Kills	24.8	23.6	23.1
K/R	0.91	0.87	0.89

Du: Wie hat NiKo in seinen letzten 20 Spielen gespielt?

Claude: NiKos aktuelle Form über 20 Spiele:

• Bilanz: 13S – 7N (65,0% Gewinnrate)

• Durchschn. K/D: 1.42 | Durchschn. Kills: 24.3 | Durchschn. HS%: 49.1%

• Aktuelle Serie: 3S

Beste Karten: de_inferno (8S-2N, 70% WR), de_ancient (4S-1N, 80% WR) Schlechteste Karte: de_vertigo (1S-3N, 25% WR)

Related MCP server: Claude Stats MCP

Tools

Alle Tools außer get_leaderboard und get_elo_trend funktionieren für jeden öffentlichen FACEIT-Spieler mit nur einem API-Schlüssel. Die Bestenlisten- und ELO-Trend-Tools erfordern eine SQLite-Datenbank mit registrierten Benutzern (siehe DB-Einrichtung).

Anforderungen

• Python 3.12+

• FACEIT Data API-Schlüssel (kostenlos)

Einrichtung

1. Klonen und Abhängigkeiten installieren

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

2. API-Schlüssel festlegen

Erstelle eine .env-Datei neben dem Skript:

FACEIT_API_KEY=your_key_here

Oder übergib ihn direkt als Umgebungsvariable in der unten stehenden Konfiguration.

Verbindung zu Claude Desktop herstellen

Füge dies zu claude_desktop_config.json hinzu:

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

Speicherort der Konfigurationsdatei:

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

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

Verbindung zu Claude Code herstellen

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

Setze dann FACEIT_API_KEY in der .env-Datei neben dem Skript.

Beispiel-Prompts

Sobald die Verbindung hergestellt ist, frage Claude einfach natürlich:

• "Was sind s1mples lebenslange Statistiken?"

• "Zeige mir die letzten 10 Spiele von NiKo"

• "Vergleiche zywoo, device und sh1ro direkt miteinander"

• "Wie hat NiKo in seinen letzten 20 Spielen abgeschnitten?"

• "Zeige das vollständige Scoreboard für Spiel 1-abc123…"

• "Auf welchen Karten spielt sh1ro am besten?"

• "Zeige die Bestenliste für unsere Gruppe"

• "Wie hat sich mein ELO im letzten Monat verändert?"

Bestenliste & ELO-Trend

get_leaderboard und get_elo_trend lesen aus einer lokalen SQLite-Datenbank. Standardmäßig befindet sich die Datenbank unter ~/.faceit-mcp/data.db und wird beim Start automatisch erstellt.

Um sie zu befüllen, verweise DB_PATH auf eine Datenbank, die eine users-Tabelle enthält:

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

Wenn du den begleitenden CS2 FACEIT Telegram-Bot verwendest, setze DB_PATH auf die Datenbank des Bots, und diese Tools werden deine registrierten Benutzer automatisch widerspiegeln.

Umgebungsvariablen

Lizenz

MIT