Mcp_mlb_statsapi

baseball-mcp：用于 MCP 的 MLB Stats API 封装

本项目提供一个 MCP（Model Context Protocol），用作 MLB Stats API 的封装。它让你能够轻松访问和处理各类 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 检索数据。