MCP Mlb Statsapi

🚀 基於MLB Stats API的MCP服務器

本項目打造了一個MCP（多通道管道）服務器，它作為MLB Stats API的包裝器，能讓您輕鬆訪問和處理各類MLB數據，像賽程、比賽結果和球隊信息等都能輕鬆搞定。此服務器專為MCP框架設計，可實現高效的數據檢索與處理。

🚀 快速開始

本項目提供的MCP服務器能讓你方便地訪問和處理MLB數據。你可以按照下面的安裝指南完成安裝，之後就能使用其豐富的功能啦。

🎥 演示視頻

以下兩個演示視頻，為你展示mcp_mlb_statsapi的強大功能：

• 演示1：MCP MLB Stats API - 快速概覽

• 演示2：MCP MLB Stats API - 輸入中文也可以

✨ 主要特性

• 比賽賽程： 可獲取指定日期範圍內的MLB比賽賽程，還能選擇過濾特定球隊。
• 比賽結果： 能獲取每日比賽結果，包含得分、勝敗球隊和獲勝投手等信息。
• 球隊結果： 可獲取特定球隊最近一場比賽的詳細結果，包括得分回合和亮點。
• 球員查找： 能使用姓氏、名字或兩者組合查找球員ID，並且支持模糊匹配。

📦 安裝指南

先決條件

• Python 3.10或更高版本
• uv包管理器：
  • Mac安裝方式：

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服務器依據MIT許可證發佈。這意味著你可以自由使用、修改和分發此軟件，但需遵循MIT許可證的條款和條件。更多細節，請查閱項目倉庫中的LICENSE文件。

📚 詳細文檔

該項目依賴以下外部庫和資源：

• MLB-StatsAPI： https://github.com/toddrob99/MLB-StatsAPI - 一個提供對MLB Stats API訪問的Python庫。本項目嚴重依賴mlb-statsapi進行數據檢索。