MCP Mlb Statsapi

🚀 基于MLB Stats API的MCP服务器

本项目构建了一个MCP（多通道管道）服务器，它作为MLB Stats API的包装器存在。借助该服务器，你能便捷地访问和处理各类MLB数据，像赛程安排、比赛结果以及球队信息等。而且，该服务器是专门为在MCP框架下实现高效的数据检索与处理而设计的。

🚀 快速开始

本项目提供了一个强大的MCP服务器，用于访问MLB Stats API，你可以按照以下步骤快速体验其功能。

🎥 演示视频

以下两个演示视频展示了mcp_mlb_statsapi的功能：

• 演示1：MCP MLB Stats API - 快速概览

• 演示2：MCP MLB Stats API - 輸入中文也可以

✨ 主要特性

• 比赛赛程：能获取指定日期范围内的MLB比赛赛程，还可选择过滤特定球队。
• 比赛结果：可获取每日比赛结果，涵盖得分、胜败球队以及获胜投手等信息。
• 球队结果：能获取特定球队最近一场比赛的详细结果，包含得分回合和亮点。
• 球员查找：支持使用姓氏、名字或两者组合查找球员ID，并且支持模糊匹配。

📦 安装指南

先决条件

• Python 3.10 或更高版本
• uv 包管理器：
  • Mac安装方式：

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](https://github.com/toddrob99/MLB - StatsAPI) ，这是一个提供对 MLB Stats API 访问的 Python 库，本项目在数据检索方面严重依赖 mlb - statsapi。