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

贡献

欢迎贡献！请打开一个问题或提交一个拉取请求。

许可证

此MCP服务器根据MIT许可证发布。这意味着您可以在遵守MIT许可证条款和条件的前提下自由使用、修改和分发软件。更多详情，请参见项目存储库中的LICENSE文件。

参考资料

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

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