Fantasy Premier League MCP Server

Fantasy Premier League (FPL) verisine ve araçlarına erişim sağlayan bir Model Context Protocol (MCP) sunucusu. Bu sunucu, Claude for Desktop ve diğer MCP uyumlu istemcilerde FPL verileriyle etkileşim kurmanızı sağlar.

Fantasy Premier League MCP Server'ın çalışması sırasında bir demo

Desteklenen Platformlar

• Claude Desktop
• Cursor
• Windsurf
• Diğer MCP Uyumlu Desktop LLM'ler

Mobil şu anda desteklenmemektedir.

Özellikler

• Zengin Oyuncu Verileri: FPL API'sinden kapsamlı oyuncu istatistiklerine erişin
• Takım Bilgileri: Premier League takımları hakkında detayları öğrenin
• Gameweek Verileri: Mevcut ve geçmiş gameweek bilgilerini görüntüleyin
• Oyuncu Arama: Oyuncuları ada veya takıma göre bulun
• Oyuncu Karşılaştırması: Herhangi iki oyuncu arasında detaylı istatistikleri karşılaştırın

Gereksinimler

• Python 3.10 veya daha yüksek sürüm
• Claude Desktop (AI entegrasyonu için)

Kurulum

Seçenek 1: PyPI'den Kurulum (Önerilir)

pip install fpl-mcp

Seçenek 1b: Geliştirme Bağımlılıklarıyla Kurulum

pip install "fpl-mcp[dev]"

Seçenek 2: GitHub'dan Kurulum

pip install git+https://github.com/rishijatia/fantasy-pl-mcp.git

Seçenek 3: Yerel Olarak Klonlama ve Kurulum

git clone https://github.com/rishijatia/fantasy-pl-mcp.git
cd fantasy-pl-mcp
pip install -e .

Sunucuyu Çalıştırma

Kurulumdan sonra, sunucuyu çalıştırmak için birkaç seçeneğiniz vardır:

1. CLI komutunu kullanma

fpl-mcp

2. Python modülünü kullanma

python -m fpl_mcp

3. Claude Desktop ile kullanma

claude_desktop_config.json dosyanızı düzenleyerek Claude Desktop'ı yüklü paketi kullanacak şekilde yapılandırın:

Yöntem 1: Python modülünü doğrudan kullanma (en güvenilir)

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

Yöntem 2: Tam yol ile yüklü komutu kullanma (pip ile kurulduysa)

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

/full/path/to/your/venv/bin/fpl-mcp kısmını çalıştırılabilir dosyanın gerçek yolu ile değiştirin. Virtual ortamınızı aktifleştirdikten sonra terminalinde which fpl-mcp komutunu çalıştırarak bunu bulabilirsiniz.

Not: Sadece "command": "fpl-mcp" kullanmak, Claude Desktop'ın sanal ortamınızın PATH'ine erişemeyebileceği için spawn fpl-mcp ENOENT hatası ile sonuçlanabilir. Tam yol veya Python modülü yaklaşımını kullanmak bu sorunu önlemeye yardımcı olur.

Kullanım

Claude for Desktop'ta

1. Claude for Desktop'ı başlatın
2. Çekiç simgesi aracılığıyla FPL araçlarını görebilirsiniz
3. Örnek sorgular:
   • "Compare Mohamed Salah and Erling Haaland over the last 5 gameweeks"
   • "Find all Arsenal midfielders"
   • "What's the current gameweek status?"
   • "Show me the top 5 forwards by points"

Fantasy-PL MCP Kullanım Talimatları

Temel Komutlar:

• Oyuncuları karşılaştır: "Compare [Player1] and [Player2]"
• Oyuncuları bul: "Find players from [Team]" veya "Search for [Player Name]"
• Maç zorluğu: "Show upcoming fixtures for [Team]"
• Kaptan tavsiyesi: "Who should I captain between [Player1] and [Player2]?"

Gelişmiş Özellikler:

• İstatistiksel analiz: "Compare underlying stats for [Player1] and [Player2]"
• Form kontrolü: "Show me players in form right now"
• Diferansiyel seçimler: "Suggest differentials under 10% ownership"
• Takım optimizasyonu: "Rate my team and suggest transfers"

İpuçları:

• Doğru sonuçlar için oyuncu adlarını spesifik olarak yazın
• Arama yaparken pozisyonları ekleyin (FWD, MID, DEF, GK)
• En iyi kaptan tavsiyesi için form, fixtures ve altta yatan istatistikleri sorun
• Spesifik metriklerin karşılaştırılmasını isteyebilirsiniz (xG, shots in box, vb.)

Geliştirme için MCP Inspector

Geliştirme ve test için:

# mcp[cli] kurulu olduğunda
mcp dev -m fpl_mcp

# Veya npx kullanarak
npx @modelcontextprotocol/inspector python -m fpl_mcp

Mevcut Kaynaklar

• fpl://static/players - Kapsamlı istatistikler ile tüm oyuncu verileri
• fpl://static/players/{name} - Ada göre oyuncu verileri arama
• fpl://static/teams - Tüm Premier League takımları
• fpl://static/teams/{name} - Ada göre takım verileri
• fpl://gameweeks/current - Mevcut gameweek verileri
• fpl://gameweeks/all - Tüm gameweeks verileri
• fpl://fixtures - Mevcut sezon için tüm maçlar
• fpl://fixtures/gameweek/{gameweek_id} - Belirli bir gameweek için maçlar
• fpl://fixtures/team/{team_name} - Belirli bir takım için maçlar
• fpl://players/{player_name}/fixtures - Belirli bir oyuncu için yaklaşan maçlar
• fpl://gameweeks/blank - Yaklaşan blank gameweekler hakkında bilgiler
• fpl://gameweeks/double - Yaklaşan double gameweekler hakkında bilgiler

Mevcut Araçlar

• get_gameweek_status - Mevcut, önceki ve sonraki gameweekler hakkında kesin bilgi alın
• analyze_player_fixtures - Bir oyuncunun yaklaşan maçlarını zorluk derecelendirmeleriyle analiz edin
• get_blank_gameweeks - Yaklaşan blank gameweekler hakkında bilgi alın
• get_double_gameweeks - Yaklaşan double gameweekler hakkında bilgi alın
• analyze_players - FPL oyuncularını birden fazla kritere göre filtreleyin ve analiz edin
• analyze_fixtures - Oyuncuların, takımların veya pozisyonların yaklaşan maçlarını analiz edin
• compare_players - Birden fazla oyuncuyu çeşitli metrikler arasında karşılaştırın
• check_fpl_authentication - FPL kimlik doğrulamasının düzgün çalışıp çalışmadığını kontrol edin
• get_my_team - Kimlik doğrulanmış takımınızı görüntüleyin (kimlik doğrulama gerekir)
• get_team - Belirli bir kimliğe sahip herhangi bir takımı görüntüleyin (kimlik doğrulama gerekir)
• get_manager_info - Yönetici detaylarını alın (kimlik doğrulama gerekir)

İstem Şablonları

• player_analysis_prompt - Bir FPL oyuncusunu derinlemesine analiz etmek için bir istem oluşturun
• transfer_advice_prompt - Bütçe ve pozisyona göre oyuncu transferleri hakkında tavsiye alın
• team_rating_prompt - Bir FPL takımını derecelendirmek ve analiz etmek için bir istem oluşturun
• differential_players_prompt - Düşük mülkiyet oranı ile diferansiyel oyuncular bulmak için bir istem oluşturun
• chip_strategy_prompt - Chip stratejisi tavsiyesi için bir istem oluşturun

Geliştirme

Özellik Ekleme

Yeni özellikler eklemek için:

1. fpl_mcp/fpl/resources/ içindeki uygun dosyaya resource handler'ları ekleyin
2. fpl_mcp/fpl/tools/ içindeki uygun dosyaya tool handler'ları ekleyin
3. Yeni resource'ları ve araçları kaydetmek için __main__.py dosyasını güncelleyin
4. Claude for Desktop'a dağıtmadan önce MCP Inspector kullanarak test edin

Kimlik Doğrulama

Kimlik doğrulama gerektiren özellikleri (örneğin, takımınıza veya özel liglere erişmek gibi) kullanmak için FPL kimlik bilgilerinizi ayarlamanız gerekir:

# Credential setup aracını çalıştırın
fpl-mcp-config setup

Bu etkileşimli araç:

1. FPL e-postanız, şifreniz ve takım kimliğiniz isteyecektir
2. Config.json veya .env dosyasında depolamayı seçmenizi sağlar
3. Kimlik bilgilerini güvenli bir şekilde ~/.fpl-mcp/ içine kaydeder

Kimlik doğrulamanızı test edebilirsiniz:

fpl-mcp-config test

Alternatif olarak, kimlik doğrulamayı manuel olarak yapılandırabilirsiniz:

1. ~/.fpl-mcp/.env dosyası oluşturun:

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

2. Veya ~/.fpl-mcp/config.json oluşturun:

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

3. Veya ortam değişkenlerini ayarlayın:

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

Sınırlamalar

• FPL API resmi olarak belgelenmemiş ve bildirim yapılmadan değişebilir
• Şu anda yalnızca okuma işlemleri desteklenmektedir

Sorun Giderme

Yaygın Sorunlar

1. Claude Desktop'ta "spawn fpl-mcp ENOENT" hatası

Bu, Claude Desktop'ın PATH'inde fpl-mcp çalıştırılabilir dosyasını bulamadığında oluşur.

Çözüm: Bu yaklaşımlardan birini kullanın:

• Config dosyasında çalıştırılabilir dosyanın tam yolunu kullanın

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

• Modülü Python ile doğrudan çalıştırın (tercih edilen yöntem)

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

2. Sunucu hemen bağlantısı kesilir

Sunucu başlarsa ancak hemen bağlantısı kesilirlerse:

• ~/Library/Logs/Claude/mcp*.log (macOS) veya %APPDATA%\Claude\logs\mcp*.log (Windows) dosyasından günlükleri kontrol edin
• Tüm bağımlılıkların kurulu olduğundan emin olun
• Hataları görmek için python -m fpl_mcp ile sunucuyu manuel olarak çalıştırmayı deneyin

3. Sunucu Claude Desktop'ta gösterilmiyor

Çekiç simgesi görüntülenmiyorsa:

• Claude Desktop'ı tamamen yeniden başlatın
• claude_desktop_config.json dosyasının doğru JSON sözdiziminde olduğunu doğrulayın
• Python veya çalıştırılabilir dosyanın yolunun mutlak olduğundan emin olun, göreceli değil

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır - detaylar için LICENSE dosyasına bakın.

Katkıda Bulunma

Katkılar hoş karşılanır! Lütfen bir Pull Request göndermekten çekinmeyin.

1. Depoyu fork edin
2. Feature branch'inizi oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'Add some amazing feature')
4. Branch'e push edin (git push origin feature/amazing-feature)
5. Bir Pull Request açın

Daha fazla detay için lütfen CONTRIBUTING.md dosyasına bakın.

Teşekkürler

• Fantasy Premier League API - Veri sağlama için
• Model Context Protocol - Bağlantı standardı için
• Claude - AI asistan yetenekleri için

Atıf

Bu paketi araştırmanızda veya projenizde kullanırsanız, lütfen bunu alıntılamayı göz önünde bulundurun:

@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},
}