faceit-mcp

ClaudeにライブのCS2 FACEITデータ（プレイヤー統計、試合履歴、並列比較、リーダーボード、ELO推移）を提供するスタンドアロンのMCPサーバーです。

Claude DesktopおよびClaude Codeで動作します。mcp、aiohttp、aiosqlite、python-dotenv以外のフレームワーク依存関係がない単一ファイル構成です。

デモ

あなた: zywoo、NiKo、sh1roを並べて比較して

Claude: 3人のプレイヤーの比較は以下の通りです：

	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を除くすべてのツールは、APIキーさえあればあらゆる公開FACEITプレイヤーに対して機能します。リーダーボードとELO推移ツールには、登録ユーザーを含むSQLiteデータベースが必要です（DBセットアップを参照）。

要件

• Python 3.12+

• FACEIT Data APIキー（無料）

セットアップ

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

その後、スクリプトの隣にある.envファイルでFACEIT_API_KEYを設定します。

プロンプトの例

接続したら、Claudeに自然に話しかけてください：

• "s1mpleの通算統計を教えて"

• "NiKoの直近10試合を見せて"

• "zywoo、device、sh1roを並べて比較して"

• "NiKoの直近20試合のパフォーマンスはどう？"

• "試合ID 1-abc123…の完全なスコアボードを表示して"

• "sh1roが得意なマップはどれ？"

• "私たちのグループのリーダーボードを表示して"

• "先月からの私のELOの変化はどう？"

リーダーボードとELO推移

get_leaderboardとget_elo_trendはローカルのSQLiteデータベースから読み取ります。デフォルトでは、データベースは~/.faceit-mcp/data.dbに配置され、起動時に自動的に作成されます。

データを投入するには、usersテーブルを持つデータベースをDB_PATHに指定します：

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

コンパニオンのCS2 FACEIT Telegram botを使用している場合は、DB_PATHをそのボットのデータベースに設定すると、これらのツールが自動的に登録ユーザーを反映します。

環境変数

ライセンス

MIT