MCP 服务器

Fantasy Premier League MCP Server

一个模型上下文协议（Model Context Protocol，MCP）服务器，提供访问梦幻英超（Fantasy Premier League，FPL）数据的接口，允许用户比较球员、查找球队信息、查看比赛周数据，并通过 Claude for Desktop 和其他兼容 MCP 的客户端获取与 FPL 相关的建议。

数据与应用分析

访问服务器

README

Fantasy Premier League MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供对 Fantasy Premier League (FPL) 数据和工具的访问。此服务器允许您在 Claude for Desktop 和其他 MCP 兼容的客户端中与 FPL 数据进行交互。

Fantasy Premier League MCP 服务器的演示

支持的平台

Claude Desktop
Cursor
Windsurf
其他 MCP 兼容的桌面 LLM

目前不支持移动设备。

功能

丰富的球员数据: 访问来自 FPL API 的全面球员统计数据
球队信息: 获取关于英超球队的详细信息
比赛周数据: 查看当前和过去的比赛周信息
球员搜索: 通过姓名或球队查找球员
球员比较: 比较任意两名球员之间的详细统计数据

要求

Python 3.10 或更高版本
Claude Desktop (用于 AI 集成)

安装

选项 1: 从 PyPI 安装 (推荐)

pip install fpl-mcp

选项 1b: 安装开发依赖项

pip install "fpl-mcp[dev]"

选项 2: 从 GitHub 安装

pip install git+https://github.com/rishijatia/fantasy-pl-mcp.git

选项 3: 克隆并在本地安装

git clone https://github.com/rishijatia/fantasy-pl-mcp.git
cd fantasy-pl-mcp
pip install -e .

运行服务器

安装后，您有几种选择来运行服务器：

1. 使用 CLI 命令

fpl-mcp

2. 使用 Python 模块

python -m fpl_mcp

3. 与 Claude Desktop 一起使用

通过编辑您的 claude_desktop_config.json 文件，配置 Claude Desktop 以使用已安装的软件包：

方法 1: 直接使用 Python 模块 (最可靠)

{
  "mcpServers": {
    "fantasy-pl": {
      "command": "python",
      "args": ["-m", "fpl_mcp"]
    }
  }
}

方法 2: 使用已安装的命令和完整路径 (如果使用 pip 安装)

{
  "mcpServers": {
    "fantasy-pl": {
      "command": "/full/path/to/your/venv/bin/fpl-mcp"
    }
  }
}

将 /full/path/to/your/venv/bin/fpl-mcp 替换为可执行文件的实际路径。您可以通过在激活虚拟环境后在终端中运行 which fpl-mcp 来找到它。

注意: 仅使用 "command": "fpl-mcp" 可能会导致 spawn fpl-mcp ENOENT 错误，因为 Claude Desktop 可能无法访问您的虚拟环境的 PATH。使用完整路径或 Python 模块方法有助于避免此问题。

用法

在 Claude for Desktop 中

启动 Claude for Desktop
您应该可以通过锤子图标看到可用的 FPL 工具
示例查询:
- "Compare Mohamed Salah and Erling Haaland over the last 5 gameweeks" (比较 Mohamed Salah 和 Erling Haaland 在过去 5 个比赛周的表现)
- "Find all Arsenal midfielders" (查找所有阿森纳中场球员)
- "What's the current gameweek status?" (当前比赛周的状态是什么？)
- "Show me the top 5 forwards by points" (按积分显示前 5 名前锋)

Fantasy-PL MCP 使用说明

基本命令:

Compare players: "Compare [Player1] and [Player2]" (比较球员: "比较 [球员1] 和 [球员2]")
Find players: "Find players from [Team]" or "Search for [Player Name]" (查找球员: "查找来自 [球队] 的球员" 或 "搜索 [球员姓名]")
Fixture difficulty: "Show upcoming fixtures for [Team]" (赛程难度: "显示 [球队] 的未来赛程")
Captain advice: "Who should I captain between [Player1] and [Player2]?" (队长建议: "我应该在 [球员1] 和 [球员2] 之间选择谁当队长？")

高级功能:

Statistical analysis: "Compare underlying stats for [Player1] and [Player2]" (统计分析: "比较 [球员1] 和 [球员2] 的潜在数据")
Form check: "Show me players in form right now" (状态检查: "现在显示状态良好的球员")
Differential picks: "Suggest differentials under 10% ownership" (差异化选择: "建议所有权低于 10% 的差异化球员")
Team optimization: "Rate my team and suggest transfers" (球队优化: "评价我的球队并建议转会")

提示:

Be specific with player names for accurate results (为了获得准确的结果，请明确球员姓名)
Include positions when searching (FWD, MID, DEF, GK) (搜索时包括位置 (FWD, MID, DEF, GK))
For best captain advice, ask about form, fixtures, and underlying stats (为了获得最佳队长建议，请询问状态、赛程和潜在数据)
Request comparison of specific metrics (xG, shots in box, etc.) (请求比较特定指标 (xG、禁区内射门等))

MCP Inspector 用于开发

用于开发和测试:

# 如果您已安装 mcp[cli]
mcp dev -m fpl_mcp

# 或者使用 npx
npx @modelcontextprotocol/inspector python -m fpl_mcp

可用资源

fpl://static/players - 所有球员数据，包含全面的统计信息
fpl://static/players/{name} - 按姓名搜索的球员数据
fpl://static/teams - 所有英超球队
fpl://static/teams/{name} - 按姓名搜索的球队数据
fpl://gameweeks/current - 当前比赛周数据
fpl://gameweeks/all - 所有比赛周数据
fpl://fixtures - 当前赛季的所有赛程
fpl://fixtures/gameweek/{gameweek_id} - 特定比赛周的赛程
fpl://fixtures/team/{team_name} - 特定球队的赛程
fpl://players/{player_name}/fixtures - 特定球员的未来赛程
fpl://gameweeks/blank - 关于未来空缺比赛周的信息
fpl://gameweeks/double - 关于未来双倍比赛周的信息

可用工具

get_gameweek_status - 获取关于当前、之前和下一个比赛周的精确信息
analyze_player_fixtures - 分析球员的未来赛程，并提供难度评级
get_blank_gameweeks - 获取关于未来空缺比赛周的信息
get_double_gameweeks - 获取关于未来双倍比赛周的信息
analyze_players - 根据多个标准过滤和分析 FPL 球员
analyze_fixtures - 分析球员、球队或位置的未来赛程
compare_players - 比较多个球员的各种指标
check_fpl_authentication - 检查 FPL 身份验证是否正常工作
get_my_team - 查看您已验证的球队 (需要身份验证)
get_team - 查看具有特定 ID 的任何球队 (需要身份验证)
get_manager_info - 获取经理详细信息 (需要身份验证)

提示模板

player_analysis_prompt - 创建一个用于深入分析 FPL 球员的提示
transfer_advice_prompt - 根据预算和位置获取关于球员转会的建议
team_rating_prompt - 创建一个用于评价和分析 FPL 球队的提示
differential_players_prompt - 创建一个用于查找所有权较低的差异化球员的提示
chip_strategy_prompt - 创建一个用于芯片策略建议的提示

开发

添加功能

要添加新功能:

在 fpl_mcp/fpl/resources/ 中的相应文件中添加资源处理程序
在 fpl_mcp/fpl/tools/ 中的相应文件中添加工具处理程序
更新 __main__.py 文件以注册新资源和工具
在部署到 Claude for Desktop 之前，使用 MCP Inspector 进行测试

身份验证

要使用需要身份验证的功能 (例如访问您的球队或私人联赛)，您需要设置您的 FPL 凭据:

# 运行凭据设置工具
fpl-mcp-config setup

此交互式工具将:

提示您输入 FPL 电子邮件、密码和球队 ID
让您选择存储在 config.json 或 .env 文件中
将凭据安全地保存到 ~/.fpl-mcp/

您可以使用以下命令测试您的身份验证:

fpl-mcp-config test

或者，您可以手动配置身份验证:

创建 ~/.fpl-mcp/.env 文件，内容如下:

FPL_EMAIL=your_email@example.com
FPL_PASSWORD=your_password
FPL_TEAM_ID=your_team_id

或者创建 ~/.fpl-mcp/config.json:

{
  "email": "your_email@example.com",
  "password": "your_password",
  "team_id": "your_team_id"
}

或者设置环境变量:

export FPL_EMAIL=your_email@example.com
export FPL_PASSWORD=your_password
export FPL_TEAM_ID=your_team_id

局限性

FPL API 没有正式文档，可能会在没有通知的情况下更改
目前仅支持读取操作

故障排除

常见问题

1. Claude Desktop 中出现 "spawn fpl-mcp ENOENT" 错误

发生此错误是因为 Claude Desktop 无法在其 PATH 中找到 fpl-mcp 可执行文件。

解决方案: 使用以下方法之一:

在您的配置文件中使用可执行文件的完整路径

{
  "mcpServers": {
    "fantasy-pl": {
      "command": "/full/path/to/your/venv/bin/fpl-mcp"
    }
  }
}

使用 Python 直接运行模块 (首选方法)

{
  "mcpServers": {
    "fantasy-pl": {
      "command": "python",
      "args": ["-m", "fpl_mcp"]
    }
  }
}

2. 服务器立即断开连接

如果服务器启动但立即断开连接:

检查 ~/Library/Logs/Claude/mcp*.log (macOS) 或 %APPDATA%\Claude\logs\mcp*.log (Windows) 中的日志
确保已安装所有依赖项
尝试使用 python -m fpl_mcp 手动运行服务器以查看任何错误

3. 服务器未显示在 Claude Desktop 中

如果锤子图标未出现:

完全重启 Claude Desktop
验证您的 claude_desktop_config.json 是否具有正确的 JSON 语法
确保 Python 或可执行文件的路径是绝对路径，而不是相对路径

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

贡献

欢迎贡献! 请随时提交 Pull Request。

Fork 存储库
创建您的功能分支 (git checkout -b feature/amazing-feature)
提交您的更改 (git commit -m 'Add some amazing feature')
推送到分支 (git push origin feature/amazing-feature)
打开一个 Pull Request

有关更多详细信息，请参阅 CONTRIBUTING.md 文件。

致谢

Fantasy Premier League API 提供数据
Model Context Protocol 提供连接标准
Claude 提供 AI 助手功能

引用

如果您在您的研究或项目中使用此软件包，请考虑引用它:

@software{fpl_mcp,
  author = {Jatia, Rishi and Fantasy PL MCP Contributors},
  title = {Fantasy Premier League MCP Server},
  url = {https://github.com/rishijatia/fantasy-pl-mcp},
  version = {0.1.0},
  year = {2025},
}