liga-record-mcp

Liga Record MCP

제 리가 헤코르드 판타지 풋볼 스쿼드를 Claude에 노출하는 MCP 서버입니다. 규칙은 도구로, 규정은 리소스로, 그리고 매 라운드 제가 실제로 내리는 결정을 위한 두 개의 프롬프트로 구성됩니다.

이 서버가 기반하는 분업은 결정적 규칙은 코드에, 판단은 Claude에게라는 것입니다. 포메이션 적법성, 예산 계산, §11 자동 교체는 여기서 계산되며 권위를 가집니다. 누구를 선발로 내보내고 누구를 팔지는 실제 데이터와 실제 규칙서를 바탕으로 Claude가 추론할 몫입니다.

설계와 이 규정 해석이 남겨 둔 규칙상의 모호성은 docs/PLANNING.md를 참고하세요.

설정

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .

에디터블 설치(editable install)는 선택 사항이 아닙니다. liga_record_mcp를 경로에 추가하고(프로젝트는 src/ 레이아웃을 사용합니다) MCP 구성이 가리키는 liga-record-mcp 실행기를 생성하기 때문입니다.

스쿼드는 data/squad.yaml에 있습니다. data/squad.example.yaml을 복사해 23명의 선수를 채우세요. 로더는 읽을 때마다 파일을 규정과 대조해 누락된 항목을 알려주므로 손으로 셀 필요가 없습니다. 두 번째 팀을 운영하려면 LIGA_RECORD_SQUAD를 다른 파일로 지정하세요.

Related MCP server: wcprediction-mcp

Claude에 연결하기

저장소 루트의 .mcp.json이 이미 서버를 선언하므로 이 프로젝트를 열면 Claude Code가 자동으로 인식합니다. CLI는 필요 없습니다. 설치 후 Claude Code를 다시 시작하고 메시지가 표시되면 서버를 승인하세요.

.mcp.json의 경로는 절대 경로이며 시스템별로 다릅니다. Windows는 상대 명령을 서버가 아닌 실행 중인 프로세스의 디렉터리를 기준으로 해석하므로, 앱이 시작할 때 상대 경로는 실패합니다. 저장소를 이동하거나 클론한 경우 해당 경로를 수정하세요.

Claude Desktop도 claude_desktop_config.json에서 동일한 형식을 사용합니다:

{
  "mcpServers": {
    "liga-record": {
      "command": "C:\\path\\to\\liga-record-mcp\\.venv\\Scripts\\liga-record-mcp.exe"
    }
  }
}

그런 다음 이렇게 물어보세요: "지금 내 선발 11명이 규정에 맞나요? 그리고 디오구 코스타가 뛰지 못하면 누가 들어오나요?"

제공하는 것

도구(Tools) — get_squad, get_player, search_squad, validate_selection, simulate_autosubs, check_transfer, project_price와 함께 실시간 사이트를 읽는 두 가지가 더 있습니다: search_market(차별화 선수를 찾기 위한 소유율을 포함한 전체 선수 풀)과 check_market_transfer(직접 입력한 호가가 아닌 실제 호가로 교체를 평가)입니다. 모든 읽기는 as_of 타임스탬프를 포함하므로 저장된 스쿼드를 실시간으로 제시하는 대신 데이터가 얼마나 최신인지 Claude가 말할 수 있습니다.

라이브 클라이언트는 설계상 읽기 전용입니다. 사이트에는 매수, 매도, 재계약 엔드포인트도 있지만(계약서는 알려져 있음) 의도적으로 구현하지 않았습니다. 이적 확정은 Record 사이트에서 사람이 클릭해야 할 몫입니다.

리소스(Resources) — ligarecord://regulamento(규칙이 적용하는 것과 동일한 상수에서 생성되므로 코드와 어긋날 수 없음) 및 ligarecord://squad.

프롬프트(Prompts) — pick_starting_xi, plan_transfers.

테스트

./.venv/Scripts/python.exe -m pytest -q

rules.py는 순수합니다. I/O, 네트워크, 시계가 전혀 없으므로 사이트에 접속하지 않고도 전체 규칙서를 테스트할 수 있습니다.

상태

1~3단계가 완료되었습니다: 규칙 엔진, 수동으로 유지 관리되는 YAML 스쿼드를 사용한 데이터 소스 시임, MCP 서버입니다.

4단계는 절반이 완료되었고, 가장 중요한 절반이 바로 배송된 절반입니다. playersearch.ashx는 498명 전체 시장에 대해 깔끔한 JSON을 반환하며 인증이 필요 없습니다(쿠키 없는 요청으로 확인됨). 따라서 계획이 4단계의 주요 위험으로 간주했던 세션 토큰 문제는 시장 데이터에서는 애초에 발생하지 않습니다.

특정 팀의 스쿼드를 읽는 데는 여전히 로그인이 필요하므로 data/squad.yaml은 수동으로 유지 관리됩니다. 그것이 남은 과제입니다.