Fantasy Premier League MCP Server

梦幻英超MCP服务器

](https://badge.fury.io/py/fpl-mcp) ](https://github.com/rishijatia/fantasy-pl-mcp/actions/workflows/package-check.yml) ](https://pypi.org/project/fpl-mcp/)  ](https://pepy.tech/project/fpl-mcp)


一种模型上下文协议（MCP）服务器，提供对梦幻英超（FPL）数据和工具的访问。此服务器允许您在Claude for Desktop和其他MCP兼容客户端中与FPL数据进行交互。

*梦幻英超MCP服务器运行演示*


支持的平台

• 克劳德桌面
• 光标
• 帆板运动
• 其他兼容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_config.json 文件：

方法1：直接使用Python模块（最可靠）

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

方法2：使用带完整路径的installed命令（如果使用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模块方法有助于避免此问题。

用法

在克劳德桌面

1. 启动Claude桌面版
2. 您应该可以通过锤子图标看到FPL工具
3. 示例查询：

- “比较穆罕默德·萨拉赫和埃尔林·哈兰德在过去5个比赛周的表现” - “查找所有阿森纳中场球员” - “当前游戏周状态如何？” - “按分数显示前5名前锋”

Fantasy PL MCP使用说明

基本命令：

• 比较玩家：“比较\[Player1\]和\[Player2\]”
• 查找球员：“从\[球队\]中查找球员”或“搜索\[球员姓名\]”
• 赛程难度：“显示\[团队\]即将到来的赛程”
• 队长建议：“在\[Player1\]和\[Player2\]之间，我应该由谁担任队长？”

高级功能：

• 统计分析：“比较\[Player1\]和\[Player2\]的基本统计数据”
• 状态检查：“立即向我展示状态良好的球员”
• 差异选择：“建议在10%所有权以下进行差异选择”
• 团队优化：“评价我的团队并建议转会”

提示：

• 明确球员姓名以获得准确结果
• 搜索时包括位置（FWD、MID、DEF、GK）
• 要获得最佳队长建议，请询问状态、赛程和基本数据
• 请求比较具体指标（xG、框内投篮等）。

MCP开发检查员

对于开发和测试：

# If you have mcp[cli] installed
mcp dev -m fpl_mcp

# Or use 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 -创建芯片策略建议提示

发展

添加功能

要添加新功能，请执行以下操作：

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

认证

要使用需要身份验证的功能（如访问您的团队或私人联赛），您需要设置您的FPL凭据：

# Run the credential setup tool
fpl-mcp-config setup

此交互式工具将：

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

您可以通过以下方式测试您的身份验证：

fpl-mcp-config test

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

1. 创建 ~/.fpl-mcp/.env 文件包含：

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

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

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

1. 或设置环境变量：

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

局限性

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

故障排除

常见问题

1.克劳德桌面中出现“spawn fpl mcp ENOENT”错误

这是因为Claude Desktop找不到 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_config.json 具有正确的JSON语法
• 确保Python或可执行文件的路径是绝对的，而不是相对的

许可证

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

贡献

欢迎投稿！请随时提交拉取请求。

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add some amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

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

致谢

• 梦幻英超API 用于提供数据
• 模型上下文协议 对于连接标准
• 克劳德 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},
}