baseball-mcp: 用于 MCP 的 MLB 统计 API 封装器

本项目提供一个 MCP (多通道管道) 服务器，作为 MLB 统计 API 的封装器。它允许您轻松访问和处理各种 MLB 数据点，包括赛程、比赛结果和球队信息。此服务器专为在 MCP 框架内高效检索和处理数据而设计。

演示视频

以下是一些演示视频，展示了 mcp_mlb_statsapi 的功能：

• 演示 1: MCP MLB 统计 API - 快速概览

• 

• 演示 2: MCP MLB 统计 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 桌面集成

转到 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"
        ]
    }
  }
}

贡献

欢迎贡献！请打开一个 issue 或提交一个 pull request。

许可证

此 MCP 服务器在 MIT 许可证下获得许可。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。

参考

本项目使用了以下外部库和资源：

• MLB-StatsAPI: https://github.com/toddrob99/MLB-StatsAPI - 一个提供对 MLB 统计 API 访问的 Python 库。本项目严重依赖 mlb-statsapi 进行数据检索。