Liga Record MCP

私のLiga RecordファンタジーサッカーのスカッドをClaudeに公開するMCPサーバーです。ルールはツールとして、規約はリソースとして、そして各ラウンドで実際に行う決定のための2つのプロンプトを提供します。

このサーバーが基づく分担：決定論的なルールはコードにあり、判断はClaudeに残ります。 フォーメーションの合法性、予算の計算、§11の自動交代はここで計算され、権威を持ちます。誰を先発させるか、誰を売るかは、実際のデータと実際のルールブックを踏まえてClaudeが推論する役割です。

設計と、この規約の解釈が残すルールの曖昧さについては、docs/PLANNING.mdを参照してください。

セットアップ

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

編集可能インストールは必須です。liga_record_mcpをパスに通し（プロジェクトはsrc/レイアウトを使用）、MCP設定が参照するliga-record-mcpランチャーを作成します。

あなたのスカッドはdata/squad.yamlに置きます。data/squad.example.yamlをコピーして、23人の選手を記入してください。ローダーは読み取りのたびにファイルを規約と照合し、不足しているものを列挙するので、手で数える必要はありません。LIGA_RECORD_SQUADを別のファイルに指定すると、2つ目のチームを実行できます。

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

その後、次のように尋ねてみてください：「現在のXIは合法ですか？ディオゴ・コスタが出場しない場合、誰が交代で入りますか？」

公開されるもの

ツール — get_squad、get_player、search_squad、validate_selection、simulate_autosubs、check_transfer、project_price、さらにライブサイトを読み取る2つ：search_market（全選手プールを所有率付きで検索し、差別化要因を見つける）とcheck_market_transfer（手入力ではなく実際の見積からトレードを価格付けする）。すべての読み取りにはas_ofタイムスタンプが付いており、Claudeは保存されたスカッドをライブとして提示するのではなく、データの鮮度を伝えることができます。

ライブクライアントは設計上読み取り専用です。サイトには購入、売却、再交渉のエンドポイントもあります（契約は既知）が、意図的に実装していません。トレードの確認は、Recordのサイトでの人間のクリックに留まります。

リソース — ligarecord://regulamento（ルールが強制する定数から生成されるため、コードから逸れることはありません）とligarecord://squad。

プロンプト — 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を返し、認証を必要としません — Cookieなしのリクエストで検証済み — そのため、計画がステップ4の主なリスクと見なしていたセッショントークンの問題は、マーケットデータにはそもそも発生しません。

特定のチームのスカッドを読み取るには依然としてログインが必要なため、data/squad.yamlは手動管理のままです。それが残りの課題です。