LiveFPL MCP Server

LiveFPL의 Fantasy Premier League 선수 가격 상승/하락 예측을 제공하는 MCP 서버입니다.

데이터는 LiveFPL의 공개 JSON 호스트(https://livefpl.us)에서 제공됩니다 — 웹사이트 자체가 로드하는 것과 동일한 엔드포인트입니다. 계정, API 키, 인증이 필요하지 않습니다.

데이터 소스 (리버스 엔지니어링)

https://www.livefpl.net/prices 페이지는 가격 예측 테이블을 다음에서 로드합니다:

리그 페이지는 서버 렌더링 HTML입니다(JSON API 없음). 라이브 게임위크 순위가 페이지에 포함되어 있으므로 서버는 해당 HTML을 가져와 파싱합니다.

prices.json 필드

플레이어 ID를 키로 사용합니다. 각 플레이어 항목:

• progress — 가격 변동까지의 현재 진행도로, 임계값 대비 비율입니다. 양수 ⇒ 상승, 음수 ⇒ 하락. +1.0은 상승 예정을, -1.0은 하락 예정을 의미합니다. 사이트에서 “Now” 열로 표시됩니다.

• progress_tonight — 다음 변동 마감 시점까지의 예상 진행도입니다. “Prediction” 열로 표시되며, 도구가 정렬에 사용하는 값입니다.

• per_hour — 시간당 진행도 변화율(“Per hr” 열).

• cost, name, team, type (GK/DEF/MID/FW).

도구

이적 추세 그래프는 top_transfers.json으로부터 클라이언트 측에서 파생됩니다(LiveFPL 페이지가 버블 차트를 만드는 것과 동일한 방식). 선수별 순 변화 = 이적 in − 이적 out, 노드 크기 = 총 거래량, 엣지 = 이적 쌍(out → in).

각 선수 결과에는 progress_now_pct, prediction_pct, per_hour_pct, direction(rise/fall/stable) 및 predicted_new_cost가 포함됩니다.

설치

cd livefpl-mcp
uv sync

실행

uv run livefpl-mcp

서버는 stdio를 통해 MCP로 통신합니다.

Claude Desktop / MCP 클라이언트 설정

MCP 클라이언트 설정(예: claude_desktop_config.json)에 추가하세요:

{
  "mcpServers": {
    "livefpl": {
      "command": "uv",
      "args": ["--directory", "C:\\path-to-mcp\\livefpl-mcp", "run", "livefpl-mcp"]
    }
  }
}

예시 프롬프트

• “곧 가격이 오를 FPL 수비수는 누구?”

• “오늘 밤 가격 하락 상위 10명을 보여줘.”

• “Haaland의 가격 예측은 어떻게 되나요?”

• “지금 가장 인기 있는 이적은 무엇인가요?”

• “리그 230412의 라이브 점수를 보여줘.”

• “지금 내 리그 230412에서 누가 게임위크 1위인가요?”

참고

• 예측은 LiveFPL의 것이며 공식 FPL 알고리즘이 아닙니다. 단일 게임위크에서 정확도가 가장 높습니다(LiveFPL은 더블 게임위크 규칙이 덜 확실하다고 언급합니다).

• 데이터는 각 도구 호출 시 실시간으로 가져옵니다.

라이선스

MIT