AI导哈

MLB数据API封装工具

一个基于MCP框架的MLB数据API封装工具，提供赛程、比赛结果、球队信息等数据的便捷访问和处理功能。

  • by mpizza
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 mpizza/mcp_mlb_statsapi

使用说明

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

该项目提供了一个MCP（模型上下文协议），作为MLB Stats 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安装

或者你可以克隆这个仓库，用soruce代码运行它。

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文件。

参考文献

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

  • 美国职业棒球大联盟统计API： https://github.com/toddrob99/MLB-StatsAPI -一个Python库，提供对MLB Stats API的访问。该项目在很大程度上依赖于 mlb-statsapi 用于数据检索。

相关 MCP