Nba MCP Server

🚀 NBA MCP 服務器

本項目是一個使用 Python 實現的 Model Context Protocol (MCP) 服務器，它就像一座橋樑，搭建在應用程序與 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

✨ 主要特性

• 即時比賽數據（比分板、戰力統計、逐節比賽）
• 球員信息和職業生涯統計
• 球隊比賽記錄和統計
• 聯賽排名
• 比賽結果和賽程

📦 安裝指南

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

💻 使用示例

基礎用法

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）
• MCP 協議用於 API 接口
• Pydantic 用於輸入驗證
• Pandas 用於數據處理

📄 許可證

該 MCP 服務器在 MIT License 下開源。