mlb_mcp

🚀 Pybaseball MCP 服务器

本项目是一个基于 FastAPI 的 MCP 服务器，借助 pybaseball 库，为用户提供 MLB 和 Fangraphs 的基础数据，方便对棒球数据进行查询和分析。

🚀 快速开始

本服务器基于 FastAPI 构建，借助 pybaseball 库提供数据支持，为你提供便捷的棒球数据查询服务。

✨ 主要特性

• /player?name=...：可按球员名称获取其 Statcast 数据，并且支持按日期范围进行筛选。
• /team_stats?team=...&year=...&type=batting|pitching：能够获取指定年份某支球队的棒球或投手统计数据。
• /leaderboard?stat=...&season=...&league=...&type=batting|pitching：用于获取 MLB 特定统计项、赛季和联赛的排行榜数据。

📦 安装指南

pip install -r requirements.txt
uvicorn main:app --reload

💻 使用示例

基础用法

以下是一些常见的请求示例：

• 球员数据：
  • GET /player?name=Mike Trout
  • GET /player?name=Shohei Ohtani&start_date=2023-04-01&end_date=2023-10-01
• 球队统计数据：
  • GET /team_stats?team=Yankees&year=2023&type=batting
  • GET /team_stats?team=Dodgers&year=2022&type=pitching
• 排行榜：
  • GET /leaderboard?stat=HR&season=2023&league=AL&type=batting
  • GET /leaderboard?stat=ERA&season=2023&league=NL&type=pitching

📚 详细文档

运行服务器后，你可以通过 http://127.0.0.1:8000/docs 访问交互式 API 文档，该文档会详细展示各个接口的参数和返回值等信息。

📄 许可证

文档未提及相关许可证信息。

由 pybaseball 和 FastAPI 提供支持