Fantasy Pl MCP

🚀 Fantasy Premier League MCP Project Documentation

This project offers an MCP (Model Context Protocol) server for the Fantasy Premier League, enabling interaction with the Claude AI assistant. Through this project, you can access FPL data and perform various operations.

🚀 Quick Start

Configuration Instructions

Adding Features

To add new features, follow these steps:

1. Add resource handlers in the appropriate files under the fpl_mcp/fpl/resources/ directory.
2. Add tool handlers in the appropriate files under the fpl_mcp/fpl/tools/ directory.
3. Update the __main__.py file to register new resources and tools.
4. Test with the MCP checker before deploying to the Claude desktop version.

Authentication

To use features that require authentication (such as accessing your team or private league), you need to set up FPL credentials:

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

This interactive tool will:

1. Prompt you to enter your FPL email, password, and team ID.
2. You can choose to store them in the config.json or .env file.
3. Securely save the credentials to the ~/.fpl-mcp/ directory.

You can test the authentication with the following command:

fpl-mcp-config test

Alternatively, you can manually configure the authentication:

1. Create a ~/.fpl-mcp/.env file and add the following content:

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

2. Or create a ~/.fpl-mcp/config.json file:

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

3. Or set environment variables:

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

✨ Features

• Access FPL data and perform various operations.
• Interact with the Claude AI assistant.

📦 Installation

There is no specific installation content provided in the original text, so this section is skipped.

💻 Usage Examples

There is no code example in the original text, so this section is skipped.

📚 Documentation

Limitations

• The FPL API has no official documentation and may change without notice.
• Currently, only read operations are supported.

Troubleshooting

Common Issues

1. "spawn fpl-mcp ENOENT" error in the Claude desktop version

This error occurs because the Claude desktop version cannot find the fpl-mcp executable in the PATH.

Solution:

• Use the full path of the executable in the configuration file:

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

• Or run the module directly with Python (recommended method):

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

2. Cannot find the fpl-mcp executable on Windows

Make sure the Python package is installed correctly. If not, install it with the following command:

pip install fpl-mcp

Then run in PowerShell:

python -m fpl_mcp.main

🔧 Technical Details

There is no specific technical implementation details in the original text, so this section is skipped.

📄 License

This project is licensed under the MIT License.

Contribution Guidelines

How to Contribute

1. Please fork this repository.
2. Create a new feature branch:

   git checkout -b feature/new-feature
   

3. Commit your changes:

   git commit -m "Add new feature"
   

4. Push to the forked repository:

   git push origin feature/new-feature
   

5. Create a Pull Request.

Code of Conduct

Please follow the Contributor Code of Conduct when contributing.

Acknowledgments

• Thanks to the support and contributions of the community.
• Special thanks to the following people: Contributors List.

This document provides you with information on the core functions, configuration methods, development guidelines, and troubleshooting of the Fantasy Premier League MCP project. For more information, please refer to the relevant links or contact the project maintainer.