Balldontlie MCP Server について
Balldontlie MCP Server は、Balldontlie API と連携する MCP サーバーで、NBA、NFL、MLB のチーム、選手、試合の情報を提供します。Claude Desktop などの LLM クライアントからスポーツデータを照会したい利用者を想定しています。README には、インタラクティブな日程を生成するプロンプトも記載されています。
主な機能
- 01NBA、NFL、MLB のチーム一覧の取得
- 02名前とページネーションによる選手検索
- 03日付とチームによる試合の絞り込み
- 04個別の試合詳細の取得
- 05インタラクティブな日程を生成する schedule_generator プロンプト
活用シーン
- 01指定日に行われる野球の試合の確認
- 02苗字によるアメリカンフットボール選手の検索
- 03日付範囲を指定した NBA 日程の生成
MCP 対応
本プロジェクトは MCP サーバーであり、チー ム、選手、試合に関するツールを MCP クライアントに提供し、日程生成のプロンプトも含みます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Balldontlie MCP サーバー
Balldontlie API を統合し、NBA、NFL、MLB の選手、チーム、試合に関する情報を提供する MCP サーバーの実装です。
ツール
-
get_teams
- 次のリーグのいずれかからチームのリストを取得します: NBA (National Basketball Association)、MLB (Major League Baseball)、NFL (National Football League)
- 入力:
league(enum ['NBA', 'NFL', 'MLB']): チームを取得するスポーツリーグ
-
get_players
- 次のリーグのいずれかから選手のリストを取得します: NBA (National Basketball Association)、MLB (Major League Baseball)、NFL (National Football League)
- 入力:
league(enum ['NBA', 'NFL', 'MLB']): 選手を取得するスポーツリーグfirstName(string, optional): 検索する選手の名lastName(string, optional): 検索する選手の姓cursor(number, optional): ページネーション用のカーソル
-
get_games
- 次のリーグのいずれかから試合のリストを取得します: NBA (National Basketball Association)、MLB (Major League Baseball)、NFL (National Football League)
- 入力:
league(enum ['NBA', 'NFL', 'MLB']): 試合を取得するスポーツリーグdates(string[], optional): 特定の日付の試合を取得します。形式: YYYY-MM-DDteamIds(string[], optional): 特定の試合のゲームを取得しますcursor(number, optional): ページネーション用のカーソル
-
get_game
- 次のリーグのいずれかから特定の試合を取得します: NBA (National Basketball Association)、MLB (Major League Baseball)、NFL (National Football League)
- 入力:
league(enum ['NBA', 'NFL', 'MLB']): 試合を取得するスポーツリーグgameId(number): get_games ツールで取得した試合の id
プロンプト
- schedule_generator
リーグ (NBA、MLB、NFL)、開始日、終了日を指定すると、Claude Desktop でインタラクティブなスケジュールを生成します。

サンプルクエリ
この MCP サーバーをインストールすると、Claude やその他の LLM に次のような質問ができます。
Show me today's baseball games.
Can you find football players with the last name Purdy?
How many NBA players have the last name Ming?
設定
API キーの取得
- Balldontlie.io でアカウントに登録します
- この MCP サーバーには無料プランで十分です
デスクトップ拡張機能 (DXT) を使用したインストール
- Releases から
dxtファイルをダウンロードします - Claude Desktop で開きます または ファイル -> 設定 -> 拡張機能 に移動し、.DXT ファイルをウィンドウにドラッグしてインストールします
Smithery 経由でのインストール
Smithery 経由で Claude Desktop 用の balldontlie-mcp を自動的にインストールするには:
npx -y @smithery/cli install @mikechao/balldontlie-mcp --client claude
Claude Desktop での使用
claude_desktop_config.json に以下を追加します:
{
"mcp-servers": {
"balldontlie": {
"command": "npx",
"args": [
"-y",
"balldontlie-mcp"
],
"env": {
"BALLDONTLIE_API_KEY": "YOUR API KEY HERE"
}
}
}
}
LibreChat での使用
mcpServers:
balldontlie:
command: sh
args:
- -c
- BALLDONTLIE_API_KEY=your-api-key-here npx -y balldontlie-mcp
ライセンス
この MCP サーバーは MIT ライセンスの下でライセンスされています。つまり、MIT ライセンスの条項と条件に従うことを条件に、このソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。
免責事項
このライブラリは balldontlie.io と公式に提携しているものではありません。これは MCP サーバーを備えた balldontlie API のサードパーティ実装です。
ホスト型デプロイメント
ホスト型デプロイメントは Fronteir AI で利用できます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。
