myersparkathleticzone-mcp

myersparkathleticzone-mcp

Myers Park High School（Mustangs）の運動部向け MCP サーバーです。スケジュール、チーム、ロースター、コーチ、ニュース、試合の配信リンクを取得できます。

認証情報は不要です。 このサーバーが読み取る情報はすべて公開されています。ログイン、API キー、ブラウザー拡張機能は不要で、動作させるための事前設定もありません。

AI によって開発・保守されています。ご自身の判断でご利用ください。

インストール

npx myersparkathleticzone-mcp

または、MCP ホストの設定に追加します。

{
  "mcpServers": {
    "myersparkathleticzone": {
      "command": "npx",
      "args": ["-y", "myersparkathleticzone-mcp"]
    }
  }
}

ツール

ツール	機能
mpaz_list_teams	年度ごとの学校のチーム一覧と、ほかのツールで必要な ID を取得します
mpaz_resolve_team	あいまいなチーム名（「varsity football」など）からチーム ID を特定します
mpaz_get_schedule	全チームの今後のイベントを取得します
mpaz_get_team_schedule	1 チームのシーズン全体のスケジュールを取得します
mpaz_get_scores	学校側の視点で勝敗または引き分けを含む、1 チームの試合結果を取得します
mpaz_get_roster	チームのコーチ陣と選手を取得します
mpaz_list_news	最近のニュース記事を取得します
mpaz_list_videos	NFHS Network の配信リンクがある試合を取得します
mpaz_list_photo_galleries	公開されている写真ギャラリーを取得します
mpaz_healthcheck	サイトにアクセスでき、解析可能かどうかを確認します

すべてのツールは読み取り専用です。サーバーによる書き込みはありません。

チームを指定するツールには、数値のチーム ID と競技のスラッグが必要です。また、チーム ID は年度によって異なります。推測せずに mpaz_resolve_team で特定してください。古い ID を指定すると、サイトは Team … Not Found ページを返します（HTTP 200）。クライアントはこれを検出して報告します。

設定

どちらも任意です。

変数	デフォルト	用途
MPAZ_SITE_URL	https://www.myersparkathleticzone.com	別の Athletic Zone の学校サイトを指定します
MPAZ_SCHOOL_ID	10150	GoFan/PlayOn の学校 ID。自校のチームと対戦相手を区別するために使用します

このサイトは PlayOn Sports / SportsEngine の「Athletic Zone」プラットフォームのテナントの 1 つです。そのため、両方を設定すると、同プラットフォーム上の別の学校にサーバーを接続できます。Myers Park に加え、Ballantyne Ridge（https://www.ballantyneridgeathleticzone.com、学校 ID 21785）でも動作を確認しています。

ホスト型デプロイは Myers Park 専用です。 ホスト型（mint / claude.ai connector）ビルドは、www.myersparkathleticzone.com のみを許可する静的な外部通信許可リストの背後で実行されます。そのため、そこで MPAZ_SITE_URL に別の学校を指定すると、すべての呼び出しが「Could not reach」で失敗します。別の学校を指定できるのは、ローカルの stdio インストール（npm / .mcpb）のみです。

既知の制限事項

以下は上流サイトの仕様であり、バグではありません。ツールは推測せず、出力でその旨を示します。

• スコアがない場合は不明であり、0 点ではありません。 上流では両チームのスコアが個別に保存されるため、片方だけ入力された試合（3-null、null-4）がよくあります。result は両方のスコアがある場合にのみ算出されます。
• Myers Park が記録しているスコアはごくわずかです。 これまでに確認された同校の試合では、終了した試合のスコアはすべて null です。そのため、シーズンの取得結果に結果のない試合予定しか含まれない場合があります。これは学校側のデータ入力によるもので、障害ではありません。
• 過去のシーズンのデータは部分的で、時期によって異なります。 過去の年度では Myers Park の /schedule は空ですが、チームごとのページでは引き続きデータを取得できます。そのため、mpaz_list_teams はスポーツページの年度横断チームセレクターにフォールバックします。このセレクターは競技のスラッグではなく チーム に紐付いているため、現在シーズン中のチームを経由しないとアクセスできません。つまり、シーズン外の競技は過去の年度について取得できず、取得可能な競技は年間を通じて変化します。結果には検索対象を示す coverage メモが含まれます。ここにチーム一覧がないことは、その学校にチームがなかった証拠にはなりません。
• ほとんどのチームはコーチを公開していますが、選手は公開していません。 そのため、ロースターが空でも正常です。
• 全校のスケジュールは今後のイベントを一定期間表示するものであり、シーズン全体ではありません。 シーズン全体を確認するには mpaz_get_team_schedule を使用してください。
• 配信リンクは NFHS Network のリンクであり、ホストされた動画クリップではありません。 再生時間は常に 0 です。

仕組み

このサイトは完全なサーバーレンダリング方式の Next.js アプリで、独自の /api/* ルートはサーバー専用であり、外部からのリクエストを拒否します。データはページの React Server Components のフライトペイロードに含まれるため、このサーバーは RSC: 1 ヘッダーを付けてページをリクエストし、埋め込まれたエンティティを抽出します。

docs/ATHLETIC-ZONE-API.md には、キャプチャしたリクエストとレスポンスの形式、ルート、失敗時の動作、除外した項目が記載されています。

開発

npm install
npm run build
npm test

ライセンス

MIT