NHL Stats

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

このライブラリは TypeScript で実装された NHL API で、モデルコンテキストプロトコル（Model-Context Protocol、MCP）パターンを採用しています。この MCP サーバーを通じて、NHL のチーム、選手、順位、試合スケジュール、統計情報などのデータにアクセスできます。

概要

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

📊 現在の状態

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

✅ 実装済みの機能

1. 順位情報（Standings）

   • リーグ全体の順位情報（コンファレンス別の細分化を含む）
   • チームの完全な戦績情報

2. チーム情報（Teams）

   • 基本的なチーム識別情報
   • 現在のチーム陣容と選手の詳細情報
   • チームの統計データ（フォワードとゴールキーパー）
   • 新人選手の追跡

3. 選手情報（Players）

   • 選手の個人背景情報
   • シーズン中とキャリアの統計データ
   • 受賞歴

4. 試合スケジュール（Schedules）

   • 現在のチームの試合スケジュール
   • 特定の日付のリーグ全体の試合スケジュール
   • これから行われる試合の情報

5. 統計情報（Statistics）

   • 現在の統計データの上位者（フォワードとゴールキーパー）
   • チーム別の統計分析

6. 試合情報（Game Information）

   • 試合のリアルタイムのスコアと状態
   • 試合のスケジュール

❌ 判明している問題

1. チーム情報の欠落

   • チーム検索でチームのコンファレンスとディビジョン情報が欠けている
   • 基本的なチームデータが不完全（都市/所在地の詳細が欠けている）

2. 試合詳細情報

   • 試合中の試合状態情報が限られている
   • 試合の逐秒データの実装にはさらなるテストが必要

3. 過去のデータ

   • シーズンごとの過去のデータへのアクセスを検証する必要がある
   • 過去の試合スケジュールの検索には追加のテストが必要

4. UI 統合

   • 現在、データ可視化用の UI コンポーネントがない
   • フロントエンドで表示するために、生データ形式を変換する必要がある

📝 タスクリスト

高優先度

• [ ] チーム情報 API を修正し、完全なチーム詳細（コンファレンス、ディビジョン、所在地）を含める
• [ ] より詳細なリアルタイム試合状態の追跡を実装する
• [ ] UI 統合用のデータ変換層を作成する
• [ ] 過去のデータエンドポイントのテストを完了する

中優先度

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

低優先度

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

🚀 クイックスタート

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/repository.git
   cd repository
   

2. 依存関係をインストールします。

   npm install
   

3. 認証情報を設定します。

   • プロジェクトのルートディレクトリに config.js ファイルを作成し、以下の内容を追加します。

     export const API_KEY = 'your_api_key';
     

4. サーバーを起動します。

   npm run dev
   

📚 ドキュメント

コア API エンドポイント

• チーム情報の取得

  • URL: /api/teams
  • メソッド: GET
  • 説明: すべての NHL チームの情報を返します。

• 選手情報の取得

  • URL: /api/players
  • メソッド: GET
  • 説明: すべての NHL 選手の情報を返します。

📄 ライセンス

このソフトウェアは MIT ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。

🚀 コントリビューションガイド

このプロジェクトへのコントリビューションを歓迎します！以下の手順に従ってください。

1. バグや改善点についてのイシューを作成します。
2. 機能ブランチを作成し、変更をコミットします。
3. レビューとマージのためにプルリクエストを送信します。

💬 連絡先

質問がある場合は、Your Name までご連絡ください。または、GitHub リポジトリ GitHub リンク をご覧ください。