# MLB Stats Server

MCP-сервер MLB Stats Server для Claude Code отдаёт агенту статистику MLB: расписания, боксскоры, Statcast, данные FanGraphs и Baseball Reference. Данные — для вопросов об играх и игроках.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 4958 установок · ★ 34 у репозитория
- Автор: etweisberg
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/etweisberg/mlb-mcp
- Обновлён: 2026-09-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — внимание: команда скачивает скрипт с astral.sh и сразу его запускает. Без явного «да» человека такие команды не запускай.
- HTML: https://affpapa.org/nevibecode/mcp/mlb-stats-server

## Что делает

Сервер даёт агенту инструменты для данных по бейсболу. Через MLB Stats API он достаёт расписание, турнирную таблицу, состав команды, боксскор, линейный счёт и лидеров лиги, а `lookup_player` находит игрока. Через `pybaseball` подключается Statcast: данные по отдельным играм, питчерам и бэттерам, exit velocity и barrels, ожидаемая статистика, перцентили, арсенал подач.

Отдельные инструменты строят графики matplotlib и возвращают их картинками в base64. Написан на Python с `mcp[cli]`, `mlb-statsapi` и `httpx`. Для локального запуска нужен uv: `uv pip install -e .`, затем `python -m mlb_stats_mcp.server`. Логи идут в stderr, а в файл их направляет `MLB_STATS_LOG_FILE`.

В режиме `--http` сервер слушает `$PORT` (по умолчанию 8081) и отдаёт MCP по адресу `/mcp`. Принимает любой Host и Origin, поэтому на открытом деплое ограничения придётся задать самому. Задавайте обе переменные, `MLB_STATS_ALLOWED_HOSTS` и `MLB_STATS_ALLOWED_ORIGINS`: если указать только хосты, сервер отклонит все браузерные клиенты.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://mlb-mcp--etweisberg.run.tools`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mlb-mcp https://mlb-mcp--etweisberg.run.tools
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add mlb-stats-server --url https://mlb-mcp--etweisberg.run.tools
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mlb-stats-server": {
            "url": "https://mlb-mcp--etweisberg.run.tools"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mlb-stats-server": {
            "type": "http",
            "url": "https://mlb-mcp--etweisberg.run.tools"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http mlb-stats-server https://mlb-mcp--etweisberg.run.tools
```

## Когда брать
- узнать счёт и дату последней или следующей игры команды
- разобрать боксскор и линейный счёт конкретного матча
- сравнить арсенал подач двух питчеров по данным Statcast
- проверить exit velocity и barrels у отбивающего
- построить график по данным `pybaseball` и получить его картинкой

## Примеры запросов агенту
- Через MLB Stats Server покажи турнирную таблицу и ближайшую игру моей команды
- Вызови `get_statcast_pitcher_pitch_arsenal` и сравни арсенал подач двух питчеров
- Найди игрока через `lookup_player` и выведи его ожидаемую статистику из Statcast

## Похожие
- [mlb-data](https://affpapa.org/nevibecode/skills/mlb-data.md) — скилл · 791 установка
- [fantasy-lineup-optimizer](https://affpapa.org/nevibecode/skills/fantasy-lineup-optimizer.md) — скилл · 426 установок
- [quick-stats](https://affpapa.org/nevibecode/skills/quick-stats.md) — скилл · 2100 установок
- [baseball-trend](https://affpapa.org/nevibecode/skills/baseball-trend.md) — скилл · 1700 установок
- [youtube-stats](https://affpapa.org/nevibecode/skills/youtube-stats.md) — скилл · 354 установки
- [Stats Compass](https://affpapa.org/nevibecode/mcp/stats-compass.md) — MCP-сервер · ★ 16 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
