Nba MCP Server

🚀 NBA MCP サーバー

Python で実装された Model Context Protocol (MCP) サーバーで、NBA の統計データとリアルタイムの試合データを提供します。

🚀 クイックスタート

このサーバーは、NBA API を介して NBA データにアクセスする一連のツールを提供します。アプリケーションと NBA データサービスの間の橋渡しとして機能し、リアルタイムの試合情報と過去の統計データを提供します。

基本的な使用法

from nba.mcp_server import NBAMCP

server = NBAMCP()
server.run()

設定

Docker での実行

1. イメージをビルドします：

   docker build -t nba_mcp_server .
   

2. コンテナを起動します：

   docker run -p 8000:8000 nba_mcp_server
   

直接実行

1. 依存関係をインストールします：

   pip install -r requirements.txt
   

2. スクリプトを実行します：

   python main.py
   

✨ 主な機能

• リアルタイムの試合データ（スコアボード、ボックススコア、ポイントバイポイント）
• 選手情報とキャリア統計
• チームの試合記録と統計
• リーグ順位
• 試合結果と日程

📦 インストール

このサーバーを使用するには、以下の手順に従ってください。

依存関係のインストール

pip install -r requirements.txt

Docker を使用する場合

docker build -t nba_mcp_server .
docker run -p 8000:8000 nba_mcp_server

💻 使用例

基本的な使用法

from nba.mcp_server import NBAMCP

server = NBAMCP()
server.run()

高度な使用法

# 高度なシナリオでの使用方法について説明
# 例えば、特定の選手やチームのデータを取得するなど

📚 ドキュメント

ツール

リアルタイムの試合データ

• nba_live_scoreboard

  • 当日の NBA のリアルタイムスコアボード（放送中または最新）を取得します。
  • 試合 ID、開始時間、スコア、放送情報を返します。

• nba_live_boxscore

  • 指定された NBA 試合 ID のリアルタイムボックススコアを取得します。
  • 詳細な選手とチームの統計データを提供します。

• nba_live_play_by_play

  • 特定の試合のリアルタイムのポイントバイポイント情報を取得します。
  • 得点、犯則、タイムアウト、選手交代などの情報を含みます。

選手情報

• nba_common_player_info

  • 選手の基本情報を取得します。
  • プロフィール、身長、体重、所属チーム、ポジションを含みます。

• nba_player_career_stats

  • 選手のキャリア統計を取得します。
  • さまざまな形式の統計データ（試合平均、総得点、36 分間あたり）を提供します。

• nba_list_active_players

  • 現在のすべてのアクティブな NBA 選手のリストを返します。

• nba_player_game_logs

  • 指定された日付範囲内の選手の試合統計を取得します。

チームデータ

• nba_team_game_logs_by_name

  • チーム名を使用してチームの試合記録を取得します。
  • チームの数字 ID を知る必要がありません。

• nba_fetch_game_results

  • 指定されたチーム ID と時間範囲内の試合結果を取得します。

• nba_team_standings

  • 指定されたシーズンとシーズンタイプの NBA チームの順位を取得します。

• nba_team_stats_by_name

  • チーム名を使用してチームの統計を取得します。
  • さまざまな集計方法（総得点、試合平均など）をサポートします。

• nba_all_teams_stats

  • 複数のシーズンにおけるすべての NBA チームの統計データを取得します。

日程情報

• nba_schedule_and_roster
  • 指定された日付の試合日程とチームのロスターを取得します。
  • 試合時間と対戦チームの情報を含みます。

🔧 技術詳細

この MCP サーバーは以下の技術を使用して実装されています：

• NBA API Python パッケージ（nba_api）
• API インターフェースに MCP プロトコル
• 入力検証に Pydantic
• データ処理に Pandas

📄 ライセンス

この MCP サーバーは MIT License の下でオープンソースとして公開されています。