MCP

🚀 BALLDONTLIE Sports MCP Server

このModel Context Protocol (MCP)サーバーは、BALLDONTLIE APIから包括的なスポーツデータへのアクセスを提供します。NBA、WNBA、NFL、MLB、EPL、NHL、NCAAF、NCAAB、MMA、2026年FIFAワールドカップ、ラ・リーガ、セリエA、ユーロピアンチャンピオンズリーグ、ブンデスリーガ、リーグ1などの統計、選手情報、試合データなどが含まれます。

✨ 主な機能

• 200以上のスポーツエンドポイント：BALLDONTLIE APIのすべてのエンドポイントに完全にアクセス可能
• 15の主要なスポーツ/リーグ：NBA、WNBA、NFL、MLB、EPL、NHL、NCAAF、NCAAB、MMA、2026年FIFAワールドカップ、ラ・リーガ、セリエA、ユーロピアンチャンピオンズリーグ、ブンデスリーガ、リーグ1
• 包括的なデータ：チーム、選手、試合、統計、順位、怪我の情報、勝敗予測オッズ、高度な分析データ
• 認証：APIキーをバックエンドにシームレスに転送
• ページネーション：カーソルベースのページネーションを完全にサポート
• エラーハンドリング：適切なエラー転送と処理
• 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の試合は何か"
• "マンチェスター・ユナイテッドの最近のEPL試合を取得して"
• "アジャ・ウィルソンのWNBAシーズン統計を表示して"
• "現在のWNBAの順位は何か"
• "NCAABトーナメントのブラケットを表示して"
• "今夜のNBA試合の勝敗予測オッズを取得して"

📚 ドキュメント

環境変数

利用可能なツール

NBA (23個のツール)

NFL (17個のツール)

（以下、各スポーツのツール情報も同様に記載しますが、省略します）

認証

サーバーはAuthorizationヘッダーを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はアクセスレベルの異なるさまざまな階層を提供しています。

• 無料: 基本的なエンドポイント（チーム、選手、試合）
• ALL-STAR ($9.99/月): 統計、怪我情報、順位を含む
• GOAT ($39.99/月): 高度な統計、試合スコア、勝敗予測オッズを含む完全アクセス

サポート

• BALLDONTLIE APIドキュメント
• Discordコミュニティ

📄 ライセンス

MIT