Statcast MCP Server

Statcast MCP服务器

A. MCP（模型上下文协议） 允许您查询的服务器 使用简明英语的MLB Statcast数据。向你的人工智能助手询问玩家、游戏、统计数据、排行榜等信息，无需编码。

建于 棒球，此服务器允许AI助手直接访问来自 棒球野蛮人, FanGraphs，以及 棒球参考.

你能问什么？

连接后，只需自然地与您的AI助手交谈：

• *“Aaron Judge在2024年7月是怎么打的？”*
• *“让我看看格里特·科尔本赛季的投球武器库”*
• *“2024年谁的出口速度最高？”*
• *“2023年底荷兰的排名是多少？”*
• *“找到最被低估的击球手——将xBA与实际BA进行比较”*
• *“整个洋基队阵容和五名先发球员的预期数据”* （使用 expected_stats_batch 名称以逗号分隔）
• *“现在谁是最快的棒球运动员？”*
• *“给我看看2024年7月4日洋基队红袜队比赛的每一个投球”*

AI会自动将您的问题转化为正确的数据查询。

示例：提示和响应

以下是使用Statcast MCP时典型交易所的样子：

提示

“格里特·科尔2023年的军火库统计数据是什么？”

回应

*他的四连队快球是他的主要武器（使用率为52.9%），对阵时BA为.202，每100次投球得分为+1.7。这次改变是他唯一的负投球（-1.3分）。*

______________________________________________________________________

另一个提示

“2024年谁的出口速度最高？”

回应

*AI呼叫 statcast_batter_exitvelo_barrels(year=2024) 并重返排行榜——Aaron Judge以97.0英里/小时的平均出场速度和21.8%的投篮命中率领先，紧随其后的是（其他顶级击球手）。..*

______________________________________________________________________

可用工具

总共46个工具。 大多数表支持可选 max_output_rows （每个工具默认值：10/50/100/200/250——请参见 参考.md)；值被固定到 5000 上面的最大核心表； 延长的 这些工具可以添加日程表、分段、拉赫曼历史、选秀/前景、战争文件、额外的Statcast防守/移动、联盟球队总数、单场比赛投球日志和击球手-投手对决摘要。呼叫 statcast_tool_directory 有关完整列表，请参阅 工具_总结.md 和 参考.md.

扩展工具（高级）

球队赛季： 使用 team_season_batting_stats / team_season_pitching_stats 带有3个字母的代码(PHI, NYY，…）以获得完整的名单 实际的 统计数据（阵容+工作人员）。首先尝试FanGraphs；如果FG失败或未返回任何结果，则使用棒球参考。

玩家搜索： 几乎每个排行榜/统计工具都接受可选功能 player_name （例如。 "Aaron Judge")因此，您可以获得该玩家的完整行，而不仅仅是表中的前50行。对于 群组 （完整阵容+轮换，“所有首发球员”），使用 expected_stats_batch 名称以逗号分隔——服务器会这样做 不 自动拉取MLB名单；明确列出名称或先解析名称（例如web/ player_lookup).音高工具已经通过以下方式命名 statcast_batter / statcast_pitcher. team_standings 只有团队。

快速开始

先决条件

• Python 3.10+ — 在这里下载 如果你没有

选项1：从PyPI安装（推荐）

# Using uv (fastest)
uv pip install statcast-mcp

# Or using pip
pip install statcast-mcp

选项2：从源代码安装

git clone https://github.com/YOUR_USERNAME/statcast-mcp.git
cd statcast-mcp
uv pip install .

设置

克劳德桌面版

将此添加到您的Claude Desktop配置文件中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "statcast": {
      "command": "statcast-mcp"
    }
  }
}

如果您从源代码安装并希望直接运行它：

{
  "mcpServers": {
    "statcast": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/statcast-mcp", "statcast-mcp"]
    }
  }
}

光标

打开 光标设置→ MCP 并添加新服务器：

• 名字: statcast
• 类型: command
• 命令: statcast-mcp

或添加到您的 .cursor/mcp.json:

{
  "mcpServers": {
    "statcast": {
      "command": "statcast-mcp"
    }
  }
}

VS代码（副本）

添加到您的VS代码 settings.json:

{
  "mcp": {
    "servers": {
      "statcast": {
        "command": "statcast-mcp"
      }
    }
  }
}

查询示例

查找玩家

“抬头看大谷正平”

返回玩家的MLBAM ID、FanGraphs ID、棒球参考ID和活跃年份。

俯仰水平数据

“给我看看2024年10月15日道奇队比赛的所有投球”

statcast_search(start_date="2024-10-15", team="LAD")

电池分析

“从2024年7月1日到7月31日，胡安·索托看到了什么投球？”

statcast_batter(player_name="Juan Soto", start_date="2024-07-01", end_date="2024-07-31")

“Aaron Judge是如何在不同的球场类型上击球的？”（例如2023年，106场比赛）

statcast_batter_pitch_arsenal(year=2023, player_name="Aaron Judge")

赛季排行榜

“谁是wRC+在2024年的顶级击球手？”

season_batting_stats(start_season=2024)

“2023年击球前200名，最低100 PA”

season_batting_stats(
    start_season=2023,
    min_plate_appearances=100,
    sort_by="SLG",
    max_output_rows=200,
)

预期统计数据（查找被低估的玩家）

“向我展示2024年预期数据远高于实际数据的击球手”

statcast_batter_expected_stats(year=2024)

“Aaron Judge在2025年的预期数据与实际数据是什么？”

statcast_batter_expected_stats(year=2025, player_name="Aaron Judge")

退出速度领导者

“2024年谁打的球最多？”

statcast_batter_exitvelo_barrels(year=2024)

投手阿森纳

“Spencer Strider投出了什么球，它们有多有效？”

statcast_pitcher_pitch_arsenal(year=2024)
statcast_pitcher_arsenal_stats(year=2024)

冲刺速度

“棒球运动中谁跑得最快？”

sprint_speed_leaderboard(year=2024)

排名

“给我看看2024年美国职业棒球大联盟的排名”

team_standings(season=2024)

百分位数排名和防御

“2024年Aaron Judge的Statcast百分位数排名是多少？”

batter_percentile_ranks(year=2024, player_name="Aaron Judge")

“谁是2024年OAA最好的防守游击手？”

outs_above_average(year=2024, position="SS")

热条纹（日期范围）

“2024年7月1日至7月31日，谁打得最好？”

batting_stats_date_range(start_date="2024-07-01", end_date="2024-07-31")

数据源

所有数据来源于：

• 棒球野蛮人 --Statcast投球水平和排行榜数据（2008+）
• FanGraphs --赛季级击球和投球统计
• 棒球参考 --玩家识别、每日统计范围和交叉引用

参考指南

有关详细的逐个工具文档、行限制、参数和使用模式，请参阅 参考.md.

社交/分享： 帖子的简短描述和标签创意在 工具_总结.md.

备注

• 日期范围：统计数据从2008年开始提供。一些指标（出口速度、发射角度）仅在2015年以后可用。
• 查询速度：日期范围越短，返回速度越快。对于音高数据，尽可能将范围保持在1-5天内。
• 速率限制：Baseball Savant将个人请求限制在约30000行。服务器自动处理拆分较大的查询。
• Markdown行显示：每个工具的markdown表的上限为 max_output_rows （默认值各不相同；硬最大值 5000 每 limits.py)因此，聊天客户端中的响应是有限的。
• 玩家姓名：工具接受“Mike Trout”、“Trout，Mike”或“Shohei Ohtani”等名称。服务器会自动将名称解析为MLB ID。

发展

# Clone the repo
git clone https://github.com/YOUR_USERNAME/statcast-mcp.git
cd statcast-mcp

# Create a virtual environment and install in editable mode
uv venv
uv pip install -e ".[dev]"

# Run the server locally
statcast-mcp

# Test with the MCP Inspector
npx @modelcontextprotocol/inspector statcast-mcp

# Smoke-test all 46 tools (needs network; ~2024 fixtures)
PYTHONPATH=src python scripts/verify_tools.py

贡献

欢迎投稿！一些想法：

• 添加更多工具（游戏分数、团队击球/投球、历史数据）
• 提高玩家名称分辨率
• 添加数据缓存以实现更快的重复查询
• 为常见分析创建提示模板

许可证

麻省理工学院