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許可證。