NHL API - モデルコンテキストプロトコル

モデルコンテキストプロトコルパターンを用いたNHL APIのTypeScript実装。このMCPサーバーは、チーム、選手、順位表、スケジュール、統計などのNHLデータへのアクセスを提供します。

概要

このライブラリは、モデルコンテキストプロトコル（MCP）を用いたNHL公式APIへのクリーンなインターフェースを提供します。NHL APIからデータを取得し、MCPツールを通じて構造化された使いやすい形式で提供することができます。

📊 現在の状態

2025 年 3 月 10 日現在、プラットフォームは次の機能を提供します。

✅ 機能

1. 順位表
   • リーグ全体の順位表と部門別内訳
   • チームの記録情報をすべて見る
2. チーム
   • 基本的なチームID情報
   • 現在の名簿情報と選手の詳細
   • チーム統計（スケーターとゴールキーパー）
   • 見込み客の追跡
3. プレイヤー
   • 選手の経歴情報
   • 現在のシーズンとキャリア統計
   • 受賞歴
4. スケジュール
   • 現在のチームスケジュール
   • 日付別リーグスケジュール
   • 今後のゲーム情報
5. 統計
   • 現在の統計リーダー（スケーターとゴールキーパー）
   • チーム別の統計内訳
6. ゲーム情報
   • ライブゲームスコアとステータス
   • 試合スケジュール

❌ 特定された問題

1. チーム情報のギャップ
   • チーム検索でチーム部門とカンファレンスの情報が見つからない
   • 基本的なチームデータが不完全です（都市/場所の詳細がありません）
2. ゲームの詳細
   • 進行中のゲームのゲーム状態情報が制限される
   • 実況データの実装にはさらなるテストが必要
3. 履歴データ
   • 季節ごとの履歴データへのアクセスには検証が必要
   • 過去のスケジュールの取得には追加のテストが必要
4. UI統合
   • 現在、データ視覚化用の UI コンポーネントはありません
   • 生データ形式はフロントエンド表示用に変換する必要がある

📝 TODOリスト

優先度が高い

• [ ] チーム情報APIを修正し、完全なチームの詳細（部門、カンファレンス、場所）を含めるようにしました。
• [ ] ライブゲームのためのより詳細なゲーム状態追跡を実装する
• [ ] UI統合のためのデータ変換レイヤーを作成する
• [ ] 履歴データエンドポイントの完全なテスト

中程度の優先度

• [ ] 標準的なデータ視覚化コンポーネントの開発
• [ ] プレーヤー画像の統合を追加
• [ ] チームロゴ/ブランド資産の実装
• [ ] すべてのデータタイプにわたる検索機能を作成する

優先度が低い

• [ ] 頻繁にアクセスされるデータのキャッシュシステムを構築する
• [ ] ファンタジーホッケーの統合ポイントを追加
• [ ] ニュース/メディア統合の開発
• [ ] ソーシャルメディアコンテンツの接続を追加する

🚀 はじめに

1. リポジトリをクローンします。
   git clone https://github.com/yourusername/nhl-mcp.git cd nhl-mcp
2. 依存関係をインストールします:
   npm install
3. API 資格情報を設定します。
   cp .env.example .env # Edit .env with your API keys
4. 開発サーバーを起動します。
   npm run dev

🔧 APIリファレンス

NHL-MCP プラットフォームは、次のコア API エンドポイントを提供します。

チーム

• get-team : チームの基本情報を取得する
• get-team-roster : 現在のチーム名簿を取得する
• get-team-stats : チームの統計情報を取得する
• get-team-prospects : チームの見込み客情報を取得する

プレイヤー

• get-player-landing : 詳細なプレーヤー情報を取得する

順位表

• get-current-standings : 現在のNHL順位表を取得する

スケジュール

• get-schedule : 一般的なスケジュール情報を取得する
• get-current-schedule : チームの今後のスケジュールを取得する
• get-date-schedule : 特定の日付のスケジュールを取得する

統計

• get-current-stat-leaders : 現在の統計リーダーを取得する
• get-current-goalie-leaders : 現在のゴールキーパーの統計リーダーを取得する

ゲーム

• get-scores-now : 現在のスコアとゲームの状態を取得する

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークする
2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
3. 変更をコミットします ( git commit -m 'Add some amazing feature' )
4. ブランチにプッシュする ( git push origin feature/amazing-feature )
5. プルリクエストを開く

📞 お問い合わせ

プロジェクト管理者: Dylan Groos

注: この README には、2025 年 3 月 10 日に実施されたテストに基づく NHL-MCP プロジェクトの現在の状態が記載されています。プラットフォームは、National Hockey League によって設定された利用規約に従って NHL データにアクセスします。