🚀 基于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。