Fantasy Premier League MCP Server

Fantasy Premier League MCP Server

site icon
2025.04.01 12
PythonFantasy Premier League数据分析体育娱乐娱乐功能
Fantasy Premier League MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专门用于提供 Fantasy Premier League (FPL) 的数据和工具。该服务允许用户在 Claude Desktop 和其他兼容 MCP 的客户端中与 FPL 数据进行交互。
View on GitHub

Overview

基本能力

产品定位

Fantasy Premier League MCP Server 是一个专门为 Fantasy Premier League (FPL) 游戏提供数据访问和分析工具的服务。它通过 MCP 协议与客户端(如 Claude Desktop)集成,提供丰富的 FPL 数据查询和分析功能。

核心功能

  • 丰富的球员数据:提供全面的球员统计数据
  • 球队信息:获取英超球队的详细信息
  • 比赛周数据:查看当前和过去的比赛周信息
  • 球员搜索:通过姓名或球队查找球员
  • 球员比较:比较任意两名球员的详细统计数据

适用场景

  • FPL 玩家进行球员分析和比较
  • 球队管理和转会决策
  • 比赛周状态和赛程查询
  • 球员表现统计和趋势分析

工具列表

  • 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:获取经理详细信息(需要认证)

常见问题解答

  1. "spawn fpl-mcp ENOENT" 错误:Claude Desktop 无法找到 fpl-mcp 可执行文件。解决方案:使用完整路径或直接通过 Python 运行模块。
  2. 服务器立即断开连接:检查日志文件,确保所有依赖项已安装。
  3. 服务器未在 Claude Desktop 中显示:重启 Claude Desktop,验证配置文件语法,确保路径是绝对路径。

使用教程

使用依赖

  • 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 .

调试方式

运行服务器

fpl-mcp

python -m fpl_mcp

在 Claude Desktop 中使用

  1. 启动 Claude Desktop
  2. 通过锤子图标访问 FPL 工具
  3. 示例查询:
  4. "Compare Mohamed Salah and Erling Haaland over the last 5 gameweeks"
  5. "Find all Arsenal midfielders"
  6. "What's the current gameweek status?"
  7. "Show me the top 5 forwards by points"

MCP 检查器用于开发

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

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。