Mcp_mlb_statsapi

baseball-mcp：MCP 向け MLB Stats API ラッパー

このプロジェクトは、MLB Stats API のラッパーとして機能する MCP（Model Context Protocol）を提供します。スケジュール、試合結果、チーム情報など、さまざまな MLB データに簡単にアクセスして処理できます。このサーバーは、MCP フレームワーク内で効率的にデータを取得、処理できるように設計されています。

デモ動画

mcp_mlb_statsapi の機能を紹介するデモ動画をいくつかご覧ください。

• デモ 1：MCP MLB Stats API - クイック概要

• 

• デモ 2：MCP MLB Stats API - 中国語で入力しても大丈夫

• 

機能

• 試合スケジュール： 指定した期間の MLB 試合スケジュールを取得します。必要に応じてチームで絞り込めます。
• 試合結果： スコア、勝敗チーム、勝利投手などを含む、日ごとの試合結果を取得します。
• チームの試合結果： 特定のチームの直近の試合について、得点プレーやハイライトを含む詳細な結果を取得します。
• 選手検索： 姓、名、またはその両方を使って選手 ID を検索します。あいまい検索にも対応しています。

インストール

前提条件

• Python 3.10 以降
• uv パッケージマネージャー：

Mac をお使いの場合は、uv を次のようにインストールしてください。

brew install uv

Windows の場合

powershell -c "irm https://astral.sh/uv/install.ps1 | iex" 

それ以外の場合は、公式サイトのインストール手順をご覧ください：uv のインストール

PyPI からインストール

mcp_mlb_statsapi パッケージは PyPI で公開されており、pip を使ってインストールできます。

pip install mcp_mlb_statsapi

Github からインストール

または、このリポジトリをクローンして、ソースコードから実行できます。

uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

Claude for Desktop との連携

Claude > Settings > Developer > Edit Config > claude_desktop_config.json に移動し、次の内容を追加します。

    {
      "mcpServers": {
        "mcp_mlb_statsapi": {
           "command": "{YOUR_PYTHON_EXECUTABLE_PATH}/python",
            "args": ["-m",
            "mcp_mlb_statsapi"]
          }
        }
    }

ソースコードからインストールした場合

{
  "mcpServers": {
    "mcp_mlb_statsapi": {
        "command": "{YOUR_UV_EXECUTABLE_PATH}/uv",
        "args": [
            "--directory",
            "{YOUR_PROJECT_PATH}/src/mcp_mlb_statsapi",
            "run",
            "mcp_mlb_statsapi"
        ]
    }
  }
}

コントリビューション

コントリビューションを歓迎します。Issue を作成するか、プルリクエストを送信してください。

ライセンス

この MCP サーバーは MIT License のもとでライセンスされています。MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。

参考資料

このプロジェクトでは、次の外部ライブラリとリソースを利用しています。

• MLB-StatsAPI： https://github.com/toddrob99/MLB-StatsAPI - MLB Stats API へのアクセスを提供する Python ライブラリです。このプロジェクトでは、データ取得に mlb-statsapi を幅広く利用しています。