# NBA MCP 服务器

一个开源的模型上下文协议（MCP）服务器，通过 nba\_api 库为 AI 代理提供实时和历史 NBA 统计数据、实时比赛比分、球员数据和球队信息。

Canonical URL: https://a2a-mcp.org/entry/nba-mcp-server-zh

Language: zh

Category: MCP Servers

Updated: 2026-04-21

## 什么是 NBA MCP 服务器？

**NBA MCP 服务器** 是一个开源的模型上下文协议（Model Context Protocol，简称 MCP）实现，它连接人工智能代理与全面的 NBA 篮球数据。它允许大型语言模型（例如 Anthropic 的 Claude）通过标准化的 MCP 工具访问实时比分、球员统计数据、球队信息、比赛记录等——无需自定义 API 封装器或手动获取数据。

它使用流行的 `nba_api` 包以 Python 构建，可将任何兼容 MCP 的客户端变为一位知识渊博的 NBA 分析师，能够回答诸如“昨晚湖人队比赛谁赢了？”或“比较勒布朗·詹姆斯本赛季与上赛季的数据”这类问题。

## 主要特性

- **实时比赛数据**：访问今日赛程表、实时比分和比赛详情。
- **球员统计数据**：任何 NBA 球员的详细职业生涯、赛季及场均数据。
- **球队信息**：阵容名单、比赛记录、排名和表现指标。
- **历史数据**：逐年统计数据、比赛汇总和高级分析。
- **MCP 工具暴露**：标准化工具如 `nba_list_todays_games`、球员查询和统计查询，AI 代理可自动发现并调用。
- **易于部署**：可在本地、通过 Docker 或作为独立服务运行。
- **轻量且快速**：依赖少，响应时间快，适合实时查询。

## 工作原理

1. 安装并运行 NBA MCP 服务器（通过 pip、uvx 或 Docker）。
2. 在您的 MCP 客户端（例如 Claude Desktop 配置）中配置服务器 URL 或命令。
3. 自然地与您的 AI 代理聊天——它会自动使用暴露的工具获取准确、最新的 NBA 数据，并将其整合到回应中。

服务器在后台处理身份验证（如需要）、数据格式化和错误处理。

## 热门实现版本

社区存在多个版本：
- **obinopaul/nba-mcp-server**：专注于核心统计数据和实时比赛。
- **labeveryday/nba-stats-mcp**：全面的实时和历史数据，安装简单。
- 其他版本则专精于球员数据（basketball-reference）、博彩赔率或高级分析。

## 使用场景

- **体育新闻与分析**：AI 驱动的赛事总结、数据比较和洞察。
- **球迷互动应用**：能够即时回答 NBA 问题的实时聊天机器人。
- **博彩与梦幻体育**：获取赔率、预测数据和表现数据（在兼容的变体中）。
- **研究与教育**：历史趋势分析和球员职业生涯深度研究。
- **多代理工作流**：与其他 MCP 服务器（例如新闻或日历服务器）结合，实现完整的体育自动化。
- **个人助理**：在直播比赛中通过事实数据解决争论。

## 快速开始

大多数版本支持快速安装：

```bash
pip install nba-stats-mcp
```

# 或使用
uvx nba-stats-mcp
```

随后将其添加至您的 Claude Desktop（或其他 MCP 客户端）配置文件。完整的安装说明（包括 Docker 选项）可在对应的 GitHub 仓库中找到。

基础 nba_api 使用无需 API 密钥（但受速率限制约束）。

## 优势

- **实时准确性**：始终获取最新数据，而非依赖过时的知识截止日期信息。
- **智能体原生设计**：专为支持工具调用的 LLM 设计。
- **开放且可扩展**：由社区驱动；易于分叉或扩展新工具。
- **隐私友好**：可在本地运行，完全掌控数据访问权限。

NBA MCP 服务器展示了领域特定的 MCP 服务器如何让专业知识对 AI 智能体即时可用，将日常对话转化为数据丰富的交互体验。

您可在 GitHub 上探索不同版本以找到最适合的方案（例如 [obinopaul/nba-mcp-server](https://github.com/obinopaul/nba-mcp-server) 或 [labeveryday/nba-stats-mcp](https://github.com/labeveryday/nba-stats-mcp)）。

## Tags

- mcp
- 模型上下文协议
- nba
- 体育数据
- 篮球
- ai代理
- python
- claude
- 实时比分
- nba-api

## Sources

- [Project website](https://github.com/obinopaul/nba-mcp-server)