MCP Mlb Statsapi

🚀 MLB Stats APIを基にしたMCPサーバー

このプロジェクトは、MLB Stats APIのラッパーとして機能するMCP（マルチチャネルパイプライン）サーバーを提供します。これにより、試合日程、試合結果、チーム情報など、様々なMLBのデータポイントに簡単にアクセスして処理することができます。このサーバーは、MCPフレームワーク内での効率的なデータ検索と処理のために設計されています。

🚀 クイックスタート

このサーバーを使用することで、MLBの様々なデータに簡単にアクセスできます。以下のセクションでは、その機能やインストール方法などを詳しく説明します。

✨ 主な機能

• 試合日程： 指定した日付範囲内の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デスクトップ統合

Claude > 設定 > 開発者 > 設定の編集 > 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"
      ]
    }
  }
}

🎥 デモビデオ

以下は、mcp_mlb_statsapiの機能を示す2つのデモビデオです：

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

• デモ2：MCP MLB Stats API - 中国語入力も可能

📄 ライセンス

このMCPサーバーはMITライセンスの下で公開されています。これは、MITライセンスの条項と条件に従う限り、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。

📚 参考資料

このプロジェクトは、以下の外部ライブラリとリソースに依存しています：

• MLB-StatsAPI： https://github.com/toddrob99/MLB-StatsAPI - MLB Stats APIへのアクセスを提供するPythonライブラリです。このプロジェクトはデータ検索にmlb-statsapiに大きく依存しています。