Balldontlie MCP

🚀 BallDontlie MCP 服務器

這是一個集成 Balldontlie API 的 MCP 服務器實現，能夠提供關於 NBA、NFL 和 MLB 球員、球隊和比賽的信息，助力用戶輕鬆獲取體育賽事相關數據。

✨ 主要特性

本服務器提供了一系列實用工具，用於獲取體育賽事的相關信息：

• get_teams
  • 功能：獲取指定聯賽的球隊列表。
  • 輸入：
    • league（枚舉 ['NBA', 'NFL', 'MLB']）：要獲取球隊的體育聯盟。
• get_players
  • 功能：獲取指定聯賽的球員列表。
  • 輸入：
    • league（枚舉 ['NBA', 'NFL', 'MLB']）：要獲取球員的體育聯盟。
    • firstName（字符串，可選）：要搜索的球員的姓。
    • lastName（字符串，可選）：要搜索的球員的名。
    • cursor（數字，可選）：分頁遊標。
• get_games
  • 功能：獲取指定聯賽的比賽列表。
  • 輸入：
    • league（枚舉 ['NBA', 'NFL', 'MLB']）：要獲取比賽的體育聯盟。
    • dates（字符串數組，可選）：獲取特定日期的比賽，格式為 YYYY - MM - DD。
    • teamIds（字符串數組，可選）：獲取指定球隊的比賽。
    • cursor（數字，可選）：分頁遊標。
• get_game
  • 功能：獲取某個特定聯賽中的某場具體比賽。
  • 輸入：
    • league（枚舉 ['NBA', 'NFL', 'MLB']）：要獲取比賽的體育聯盟。
    • gameId（數字）：從 get_games 工具獲得的比賽編號。

💡 提示

• schedule_generator 根據給定的聯賽（NBA、MLB、NFL）、開始日期和結束日期，在 Claude Desktop 中生成一個交互式日程安排。

📦 安裝指南

獲取 API 密鑰

1. 在 Balldontlie.io 註冊並登錄。
2. 生成 API 密鑰。

安裝命令

使用以下命令安裝：

npx -y @smithery/cli install @mikechao/balldontlie-mcp

配置文件

在 balldontlie-mcp.config.js 文件中進行配置：

module.exports = {
  // API 密鑰在此處配置
}

💻 使用示例

基礎用法

const { balldontlieMCP } = require('@mikechao/balldontlie-mcp');

// 獲取球隊列表示例
balldontlieMCP.getTeams({ league: 'NBA' })
  .then(teams => console.log(teams))
  .catch(error => console.error('Error:', error));

// 獲取球員列表示例
balldontlieMCP.getPlayers({ league: 'NFL', firstName: 'John', lastName: 'Doe' })
  .then(players => console.log(players))
  .catch(error => console.error('Error:', error));

📄 許可證

本項目採用 MIT License 許可證。

⚠️ 免責聲明

該項目與任何第三方服務或公司無關，僅為學習和研究目的而開發。