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进行数据检索。