Faceit Mcp

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%）

ツール

ツール	説明
get_player_stats	ELO、スキルレベル、地域、生涯 K/D、HS%、勝率、連勝・連敗
get_match_history	直近 N 試合のマップ、勝敗、K/D、キル数、HS%、K/R
compare_players	2～6 人の FACEIT ニックネームの統計を並べて比較
get_recent_form	直近 N 試合の集計統計：勝率、平均 K/D、現在の連勝・連敗、マップ別内訳
get_match_details	ID で指定した試合の完全なスコアボード：チーム、スコア、全プレイヤーの統計、複数キル
get_player_map_stats	生涯のセグメントデータに基づくマップ別の勝率、K/D、HS%、K/R
get_leaderboard	ライブ ELO 順に並べた登録ユーザー
get_elo_trend	登録ユーザーの保存済み ELO スナップショット

get_leaderboard と get_elo_trend を除くすべてのツールは、API キーだけで任意の公開 FACEIT プレイヤーに対して利用できます。リーダーボードと ELO 推移のツールには、登録ユーザーを含む SQLite DB が必要です（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 試合の調子はどう？」
• 「試合 1-abc123… の完全なスコアボードを見せて」
• 「sh1ro が最も得意なマップはどれ？」
• 「グループのリーダーボードを見せて」
• 「この 1 か月で ELO はどう変化した？」

リーダーボードと ELO の推移

get_leaderboard と get_elo_trend はローカルの SQLite データベースを読み込みます。デフォルトでは DB は ~/.faceit-mcp/data.db に保存され、起動時に自動作成されます。

データを入力するには、users テーブルを含むデータベースを DB_PATH に指定します。

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

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

環境変数

変数	必須	デフォルト	説明
FACEIT_API_KEY	はい	—	FACEIT Data API v4 キー
DB_PATH	いいえ	~/.faceit-mcp/data.db	SQLite データベースのパス
FACEIT_CIRCUIT_FAILURE_THRESHOLD	いいえ	4	サーキットが開くまでの連続失敗回数（0 で無効化）
FACEIT_CIRCUIT_OPEN_SEC	いいえ	60	サーキットが開いた状態を維持する時間（秒）

ライセンス

MIT