FPL MCP

AI로 Fantasy Premier League 팀을 관리하세요. MCP 서버로, Claude와 같은 LLM 클라이언트가 FPL 팀을 읽고, 선수와 일정을 분석하고, 이적을 제안하고, 미니 리그 라이벌을 염탐하고, 실제로 이적을 수행하고 주장을 지정하고 칩을 사용할 수 있게 해줍니다 — 모두 자연어 대화로 처리됩니다.

⚠️ 비공식. 프리미어리그와 제휴, 보증, 또는 관련이 없습니다. 공개 FPL API를 사용합니다. 전적으로 여러분의 컴퓨터에서 실행됩니다 — 세션 토큰은 컴퓨터를 떠나지 않으며, 비밀번호는 이 도구나 모델이 절대 볼 수 없습니다.

데모

한 문장으로 여러 작업 — 이적, 주장 변경, 라인업 교체를 실제 팀에서 모두 실행합니다:

"조앙 페드루를 이적시키고, 하베르츠를 영입하고, 홀란드를 주장으로 만들고, 르 페 대신 예이츠를 선발 라인업에 넣어줘"

Related MCP server: FPL MCP Server

차별점

대부분의 FPL 도구는 데이터를 읽고 조언만 제공하며, 이후에는 직접 적용해야 합니다. 하지만 이 도구는:

• 실제로 팀을 관리합니다 — 이적, 주장, 라인업, 칩을 실제로 실행합니다.

• 비밀번호를 건드리지 않고 로그인합니다 — 실제 브라우저가 열리고, 공식 FPL 페이지에서 직접 로그인하며, 세션 토큰만 캡처됩니다.

• 미니 리그를 염탐합니다 — 라이벌의 스쿼드는 공개되어 있으므로, 리그 내 보유율을 계산하고 우위와 위협을 알려줍니다.

• 포지션을 고려한 모델로 이적을 제안합니다 — 세 가지 전략: 최고 포인트, 안전한 템플릿 픽, 또는 순위 상승을 위한 디퍼렌셜.

도구

로그인 작동 방식 (그리고 왜 안전한지)

FPL은 토큰 기반 로그인(PingOne OIDC)으로 전환했습니다. 비밀번호를 묻는 대신 login_to_fpl:

1. 공식 FPL 사이트에서 실제 브라우저 창을 엽니다.

2. 여러분이 직접 그곳에서 로그인합니다.

3. 세션 토큰은 네트워크 트래픽에서 읽혀 로컬의 token.txt에 저장됩니다.

비밀번호는 FPL 자체 페이지에만 입력됩니다 — 이 코드나 모델에는 절대 전달되지 않습니다. 봇 탐지를 우회하지 않습니다. 사람이 로그인합니다. 전체 기술 문서는 docs/FINDINGS.md를 참조하세요.

요구 사항

• Python 3.12+

• uv

• Node.js (개발 중 MCP Inspector를 사용하는 경우에만 필요)

설정

git clone https://github.com/MoayadAbbara/FPL-MCP.git
cd FPL-MCP
uv sync --extra browser      # includes Playwright for browser login
uv run playwright install chromium

Claude에 연결하기

MCP 클라이언트에 서버를 등록하세요. Claude Code의 경우:

claude mcp add fpl -- uv run --directory /path/to/FPL-MCP python src/server.py

또는 클라이언트의 MCP 구성(.mcp.json / claude_desktop_config.json)에 추가하세요:

{
  "mcpServers": {
    "fpl": {
      "command": "uv",
      "args": ["run", "python", "src/server.py"],
      "cwd": "/path/to/FPL-MCP"
    }
  }
}

클라이언트를 다시 시작한 다음, 그냥 대화하세요.

사용법

연결되면 자연어를 사용하세요:

"Sign in to FPL"
"Show my team"
"Any injury news on Arsenal players?"
"Compare Haaland and Gyökeres"
"Suggest transfers — differential mode"
"Analyse my mini-league 123456"
"Transfer out Haaland, bring in João Pedro, and make Watkins captain"

모델이 적절한 도구를 호출하고, 팀을 변경하는 모든 작업에 대해 무엇을 했는지 알려줍니다.

아키텍처

계층 구조 — 각 계층은 바로 아래 계층만 알고 있습니다:

src/
  tools/    MCP tool surface (thin glue: fetch -> domain -> format -> text)
  format/   raw data -> compact, model-friendly text
  domain/   pure FPL logic (scoring, suggestions, roster maths) — no HTTP, no MCP
  api/      FPL HTTP client
  auth/     token capture (browser) and storage
  server.py entry point

원시 FPL JSON은 모델에 도달하지 않습니다. 모든 것이 domain/을 거친 다음 format/을 거치므로 의사 결정에 관련된 필드만 남습니다.

개발

uv run ruff format . && uv run ruff check --fix .   # format + lint
uv run python src/server.py                          # run the server (stdio)

참고 사항

• 시즌 의존 도구(suggest_transfers, analyze_mini_league)는 시즌이 시작된 후에 가장 잘 작동합니다. 첫 번째 마감 전에는 명확한 "아직 아님" 메시지를 반환합니다.

• 팀 관리 자동화는 FPL 서비스 약관에 저촉될 수 있습니다. 자신의 팀에만 사용하고, 개인 용도로만 유지하며, 요청이 있으면 중단하세요.

라이선스

MIT