基于MLB Stats API的MCP服务器

该项目提供了一个MCP（多通道管道）服务器，作为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桌面集成

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