Rails Hyperdrive MCP
Dev-движок Rails подключает агента к запущенному приложению: восемь MCP-инструментов и навыки под гемы вашего Gemfile.
- 81 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Инструмент `run_ruby` выполняет произвольный Ruby в запущенном процессе приложения.
- Агент читает базу, модели и логи разработки.
Установка
- Работает в
Ручная установка
bundle add rails-hyperdrive --group=developmentСледом `bin/rails hyperdrive:init`. Необязательно: парный гем, например `bundle add rails-hyperdrive-sidekiq --group=development`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент `run_ruby` выполняет произвольный Ruby в запущенном процессе приложения.
- Агент читает базу, модели и логи разработки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Rails Hyperdrive монтирует в приложение MCP-сервер по адресу `http://localhost:3000/_hyperdrive/mcp`. Восемь инструментов отвечают из запущенного процесса: `run_ruby` выполняет Ruby, `run_sql` делает запросы только на чтение (до 100 строк), `tail_logs` читает хвост лога, `list_models` и `list_routes` описывают модели и маршруты, `locate_source` находит файл и строку, `lookup_doc` открывает RDoc, `describe_app` показывает версии и гемы. Вторая половина задачи: команда `bin/rails hyperdrive:init` находит скиллы, правила, агентов и команды, которые поставляют парные гемы, и ставит только подходящие вашему Gemfile. Содержимое приходит из гемов вида `rails-hyperdrive-<имя>`, а сам гем служит механизмом установки.
Для кого. Рельсовым разработчикам, которые правят приложение вместе с Claude Code и хотят, чтобы агент видел живую схему, маршруты и логи, а не гадал по исходникам.
Подходит, если
- Агент выбирает не ту ассоциацию, и вы даете ему `list_models`, чтобы он увидел колонки и валидации.
- Нужно понять, какой контроллер обслуживает маршрут, не листая файлы.
- Фоновая задача на Sidekiq падает, и агенту нужен хвост лога и правила идемпотентности.
- Команда ставит в проект гем с правилами под их стек и подключает их одной командой.
Не подходит, если
- Приложение не в режиме разработки: движок отказывает вне `Rails.env.development?`.
- Нужен доступ к боевым данным, а инструмент рассчитан только на локальную среду.
- Агент не должен выполнять произвольный Ruby в процессе приложения.
Пример запроса к агенту
Покажи через Hyperdrive модель Order с ассоциациями, затем маршруты, которые с ней работают, и последние ошибки из лога разработки.MCP
- Транспорт
- http
- Авторизация
- не нужна
Ограничения
Движок только для разработки: он отвечает лишь в `Rails.env.development?`, пропускает источники `localhost`, `127.0.0.1` и `[::1]`, и каждый инструмент перепроверяет режим при вызове. Инструмент `run_ruby` выполняет произвольный код внутри загруженного процесса, поэтому подключайте его к приложению с тестовыми данными. Сам гем не несет скиллов и правил: без парных гемов вы получите только MCP-инструменты. Маршрут `/_hyperdrive` команда пишет в `config/routes.rb`, путь меняется флагом `--mount-at`.
Как отключить. Уберите гем из Gemfile, удалите строку маршрута из `config/routes.rb`, файлы `.mcp.json` и `.hyperdrive/`, а также установленные скиллы и правила из `.claude/`.
Частые вопросы
Как подключить Rails Hyperdrive?
Добавьте гем командой `bundle add rails-hyperdrive --group=development`, выполните `bin/rails hyperdrive:init` и запустите сервер. Claude Code, открытый в каталоге проекта, прочитает `.mcp.json`.
Что отдает ресурс stack-profile?
Ресурс `hyperdrive://stack-profile` отдает JSON-снимок вашего стека, а `hyperdrive://skills/{name}` выдает текст установленного скилла.
Где взять знания под мой стек?
Подключите парный гем, например `rails-hyperdrive-sidekiq`, и снова запустите `bin/rails hyperdrive:init`. Он поставит только то, что подходит вашему Gemfile.
Можно ли поменять адрес сервера?
Да, флаг `--mount-at /путь` двигает и маршрут, и адрес в `.mcp.json`. Путь состоит из сегментов через `/`.
Работает ли Hyperdrive в production?
Нет. Движок отвечает только в `Rails.env.development?` и пропускает источники `localhost`, `127.0.0.1` и `[::1]`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыГем с MCP-сервером для Rails: агент читает схему, модели, маршруты и тесты приложения и перестает угадывать их по шаблону.
MCP-сервер и плагин для агентов генерируют веб-API из спецификаций OpenAPI, AsyncAPI, GraphQL, gRPC и SQL на ядре Rust.
Скилл и плагин RubyLLM помогают агенту писать чаты, инструменты, MCP и структурированный вывод в приложениях на Ruby и Rails
MCP-сервер Apollo: превращает заданные операции GraphQL в инструменты, через которые агент работает с вашим API
MCP-сервер Rebase: агент правит схему, документы и пользователей бэкенда на Postgres, запись разрешена лишь на localhost
MCP-сервер очереди задач bunqueue: агент ставит cron, повторяет упавшие задачи, ставит лимиты и читает статистику, без Redis.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Rails Hyperdrive (эта карточка) | нет | не нужна | 81 | |
| Rails MCP Server | да | не нужна | 573 | дает MCP-доступ к проекту Rails; Hyperdrive работает внутри запущенного приложения и подбирает скиллы под гемы |
| Layered Rails Skills | нет | 479 | только набор скиллов; Hyperdrive добавляет живой MCP и установку знаний из парных гемов |
Коротко о README
Движок разработки для Rails: MCP-сервер внутри приложения плюс установщик знаний из парных гемов. Контент не входит в ядро.