MCP

🚀 BALLDONTLIE体育MCP服务器

BALLDONTLIE体育MCP服务器是一个模型上下文协议（MCP）服务器，它提供对BALLDONTLIE API中全面体育数据的访问。这些数据涵盖了NBA、WNBA、NFL、MLB、EPL、NHL、NCAAF、NCAAB、MMA、2026年国际足联世界杯、西甲、意甲、欧冠、德甲和法甲等赛事的统计数据、球员信息、比赛数据等。

✨ 主要特性

• 200多个体育端点：可完全访问所有BALLDONTLIE API端点。
• 15项主要体育赛事/联赛：包括NBA、WNBA、NFL、MLB、EPL、NHL、NCAAF、NCAAB、MMA、2026年国际足联世界杯、西甲、意甲、欧冠、德甲和法甲。
• 全面的数据：涵盖球队、球员、比赛、统计数据、排名、伤病情况、博彩赔率和高级分析等。
• 身份验证：可无缝将API密钥转发到后端。
• 分页功能：完全支持基于游标（cursor）的分页。
• 错误处理：能正确转发和处理错误。
• TypeScript支持：具备完整的类型安全和智能感知（IntelliSense）支持。

📦 安装指南

npm install @balldontlie/mcp-server

🚀 快速开始

1. 获取API密钥

在BALLDONTLIE上注册，以获取免费的API密钥。

2. 配置MCP客户端

选项A：使用托管的远程服务器（推荐）

将以下配置添加到你的MCP客户端配置文件（例如Claude Desktop）中，以使用托管服务器：

{
  "mcpServers": {
    "balldontlie-api": {
      "url": "https://mcp.balldontlie.io/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "<YOUR_BALLDONTLIE_API_KEY>"
      }
    }
  }
}

请将<YOUR_BALLDONTLIE_API_KEY>替换为你从BALLDONTLIE获取的实际API密钥。

选项B：从源代码运行

克隆并从源代码运行：

git clone https://github.com/balldontlie-api/mcp-server.git
cd mcp-server
npm install
npm run build
npm start

配置你的MCP客户端以连接到本地服务器：

{
  "mcpServers": {
    "balldontlie-api": {
      "url": "http://localhost:3000/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "<YOUR_BALLDONTLIE_API_KEY>"
      }
    }
  }
}

3. 在你的MCP客户端中使用

服务器将自动提供所有可用的工具。你可以向你的AI助手提出以下问题：

• "获取当前NBA的排名情况"
• "展示勒布朗·詹姆斯的赛季数据"
• "今天有哪些NFL比赛？"
• "获取曼联最近的英超比赛信息"
• "展示阿贾·威尔逊的WNBA赛季数据"
• "当前WNBA的排名如何？"
• "展示NCAAB锦标赛的赛程表"
• "获取今晚NBA比赛的博彩赔率"

📚 详细文档

环境变量

可用工具

NBA（23个工具）

NFL（17个工具）

MLB（12个工具）

EPL（17个工具）

NHL（14个工具）

WNBA（14个工具）

NCAAF（17个工具）

NCAAB（18个工具）

MMA（12个工具）

2026年国际足联世界杯（6个工具）

西甲（11个工具）

意甲（11个工具）

欧冠（12个工具）

德甲（11个工具）

法甲（11个工具）

身份验证

服务器会将授权头信息转发到BALLDONTLIE API。你的MCP客户端应在请求中包含API密钥：

Authorization: YOUR_API_KEY

错误处理

服务器提供详细的错误信息：

• 身份验证错误（401）：缺少或无效的API密钥。
• 授权错误（403）：访问级别不足。
• 验证错误（400）：无效的参数。
• 限速错误（429）：请求速率超过限制。
• 服务器错误（5xx）：后端API出现问题。

开发

# 克隆并安装依赖
git clone <repository>
cd mcp-server
npm install

# 构建项目
npm run build

# 在开发模式下运行
npm run dev

# 清理构建文件
npm run clean

API层级

BALLDONTLIE提供不同的访问层级：

• 免费版：基本端点（球队、球员、比赛）。
• 全明星版（每月9.99美元）：包括统计数据、伤病情况、排名等。
• 传奇版（每月39.99美元）：全面访问，包括高级统计数据、比赛数据统计、博彩赔率等。

支持

• BALLDONTLIE API文档
• Discord社区

📄 许可证

本项目采用MIT许可证。