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
爆头率	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 | 平均爆头率： 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 数据库（参见 数据库设置）。

要求

• 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 在哪些地图上表现最好？"

• "显示我们群组的排行榜"

• "我上个月的 ELO 变化如何？"

排行榜与 ELO 趋势

get_leaderboard 和 get_elo_trend 从本地 SQLite 数据库读取数据。默认情况下，数据库位于 ~/.faceit-mcp/data.db，并在启动时自动创建。

要填充数据，请将 DB_PATH 指向一个包含 users 表的数据库：

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

如果你使用配套的 CS2 FACEIT Telegram 机器人，将 DB_PATH 设置为该机器人的数据库，这些工具将自动反映你的注册用户。

环境变量

许可证

MIT