Fantasy Pl MCP

🚀 梦幻英超联赛 MCP 项目文档

本项目搭建了一个梦幻英超联赛（Fantasy Premier League）的 MCP（模型上下文协议）服务器，可与 Claude AI 助手实现交互。借助该项目，您能够访问 FPL 数据并开展各类操作。

🚀 快速开始

此项目提供了一个梦幻英超联赛（Fantasy Premier League）的 MCP（模型上下文协议）服务器，允许与 Claude AI 助手进行交互。通过此项目，您可以访问 FPL 数据并执行各种操作。

✨ 主要特性

• 提供 MCP 服务器，可与 Claude AI 助手交互。
• 支持访问 FPL 数据并执行多种操作。

📦 安装指南

文档未提及安装步骤，因此跳过此章节。

💻 使用示例

文档未提供代码示例，因此跳过此章节。

📚 详细文档

配置说明

添加功能

若要添加新功能，可按以下步骤操作：

1. 在 fpl_mcp/fpl/resources/ 目录下的适当文件中添加资源处理程序。
2. 在 fpl_mcp/fpl/tools/ 目录下的适当文件中添加工具处理程序。
3. 更新 __main__.py 文件以注册新的资源和工具。
4. 使用 MCP 检查器进行测试，然后再部署到 Claude 桌面版。

认证

若要使用需要认证的功能（如访问您的球队或私人联赛），您需要设置 FPL 资格：

# 运行资格设置工具
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
   

2. 或创建 ~/.fpl-mcp/config.json 文件：

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

3. 或设置环境变量：

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

限制

• FPL API 没有官方文档，可能会在没有通知的情况下更改。
• 当前仅支持读操作。

故障排除

常见问题

1. 在 Claude 桌面版中出现 "spawn fpl-mcp ENOENT" 错误

此错误发生是因为 Claude 桌面版无法在 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.main"]
      }
    }
  }
  

2. 在 Windows 上找不到 fpl-mcp 可执行文件

请确保 Python 包已正确安装。如果尚未安装，请使用以下命令进行安装：

pip install fpl-mcp

然后在 PowerShell 中运行：

python -m fpl_mcp.main

🔧 技术细节

文档未提供具体的技术实现细节（字数少于 50 字），因此跳过此章节。

📄 许可证

此项目受 MIT License 许可。

贡献指南

如何贡献

1. 请 fork 此仓库。
2. 创建一个新的功能分支：

   git checkout -b feature/new-feature
   

3. 提交您的更改：

   git commit -m "添加新功能"
   

4. 推送到叉出的仓库：

   git push origin feature/new-feature
   

5. 创建一个 Pull Request。

行为准则

请在贡献时遵守 Contributor Code of Conduct。

鸣谢

• 感谢社区的支持和贡献。
• 特别感谢以下人员：Contributors List。

此文档为您提供梦幻英超联赛 MCP 项目的核心功能、配置方法、开发指南以及故障排除等信息。如需更多信息，请参考相关链接或联系项目维护者。