Balldontlie MCP

🚀 BallDontlie MCP サーバ

このサーバは Balldontlie API を統合した MCP サーバの実装で、NBA、NFL、MLB の選手、チーム、試合に関する情報を提供します。

🚀 クイックスタート

この BallDontlie 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 のライセンスの下で提供されています。

免責事項

このプロジェクトは、学習および研究目的で開発されたものであり、いかなるサードパーティのサービスや会社とも関係ありません。