Fantasy Pl MCP

🚀 梦幻英超联赛 MCP プロジェクトドキュメント

このプロジェクトは、梦幻英超联赛（Fantasy Premier League）の MCP（モデルコンテキストプロトコル）サーバーを提供し、Claude AI アシスタントとの対話を可能にします。このプロジェクトを通じて、FPL データにアクセスし、様々な操作を実行できます。

🚀 クイックスタート

このプロジェクトを通じて、梦幻英超联赛のデータにアクセスし、Claude AI アシスタントとの対話が可能になります。以下に、プロジェクトの設定や操作方法を説明します。

✨ 主な機能

• 梦幻英超联赛（Fantasy Premier League）の 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 デスクトップ版が fpl-mcp 実行ファイルを PATH 内で見つけられない場合に発生します。

解決策：

• 実行ファイルの完全パスを設定ファイルに使用します。

  {
    "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

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。

🤝 コントリビューションガイド

コントリビュートの方法

1. このリポジトリをフォークしてください。
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 プロジェクトの主要機能、設定方法、開発ガイド、トラブルシューティングなどの情報を提供しています。詳細な情報が必要な場合は、関連リンクを参照するか、プロジェクトのメンテナに連絡してください。