rails-ai-context MCP
Гем с MCP-сервером для Rails: агент читает схему, модели, маршруты и тесты приложения и перестает угадывать их по шаблону.
- 186 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Инструменты читают код и схему приложения, а `query` выполняет чтение из базы разработки.
Установка
- Работает в
Ручная установка
bundle add rails-ai-context --group developmentПервая команда из README для ручной установки; затем `bin/rails generate rails_ai_context:install --tools claude --defaults`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструменты читают код и схему приложения, а `query` выполняет чтение из базы разработки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
rails-ai-context — гем для Rails 7.0–8.1 с 35 инструментами, которые читают само приложение. Агент спрашивает таблицу и получает колонки, индексы и модель, перед вызовом ассоциации видит опции и валидации, перед написанием экшена узнает, откуда унаследованы фильтры. Для теста гем подсказывает фреймворк, расположение фабрик и их трейты, для метода показывает определение и всех вызывающих. Инструменты работают тремя способами: MCP-сервер по stdio или HTTP, статические файлы контекста (`CLAUDE.md`, `.cursor/rules/` и подобные) и обычный CLI без сервера. Если приложение не запускается, гем читает `config/routes.rb`, дамп схемы и исходники и помечает недоступные данные как `UNAVAILABLE`. Каждый ответ сообщает, насколько он надежен, и подсказывает следующий вызов.
Для кого. Разработчикам Rails-приложений с нетривиальной схемой, у которых агент то и дело вызывает несуществующие ассоциации и колонки.
Подходит, если
- Агент пишет миграцию для колонки, которая в таблице уже есть.
- В контроллере теряется `before_action`, унаследованный от родителя.
- Для новой модели надо написать тест в стиле проекта: с вашими фабриками и трейтами.
- Перед переименованием метода нужен список всех мест, где его вызывают.
- Приложение не стартует в окружении агента, но схему и маршруты прочитать все равно надо.
Не подходит, если
- Проект не на Rails: гем знает только его устройство.
- Rails 9 или Ruby старее 3.1: версии за пределами таблицы совместимости не поддерживаются.
- Агенту нужно писать в базу или менять приложение через инструмент: все 35 инструментов только читают.
Пример запроса к агенту
Какие колонки у таблицы users и какие фильтры наследует AdminController? Прежде чем править код, спроси это у rails-ai-context.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Нужны Ruby 3.1 и новее и Rails от 7.0 до 8.1; Rails 9 не поддерживается. Без запуска приложения отвечают 32 из 40 интроспекторов. Остальные возвращают `UNAVAILABLE`: инструменты `query`, `runtime_info` и `doctor` требуют загруженного приложения, а `query` еще и базы. Запросы `query` на SQLite под Windows идут без лимита по времени, потому что там нет `fork`. Первый запуск требует подтверждения MCP-сервера в самом агенте (в Claude Code это новая сессия и одобрение `rails-ai-context`). Опционально нужны `brakeman`, `listen` и `ripgrep`.
Как отключить. Уберите гем из `Gemfile`, удалите созданные установщиком файлы (`.mcp.json`, правила Cursor, блок между маркерами в `CLAUDE.md`) и выполните `bundle install`. Для плагина Claude Code используйте `claude plugin uninstall rails-ai-context`.
Частые вопросы
Нужна ли поддержка MCP в моем агенте?
Нет. Те же инструменты доступны как статические файлы контекста и как CLI: `rails-ai-context tool schema --table users`. MCP-сервер дает самый удобный вариант, если агент его поддерживает.
Как поставить гем для Claude Code?
Выполните `bundle add rails-ai-context --group development`, затем `bin/rails generate rails_ai_context:install --tools claude --defaults`. После этого откройте новую сессию в папке приложения и одобрите `rails-ai-context`; проверка командой `/mcp`.
Что делает плагин для Claude Code?
Он добавляет MCP-сервер и дает каждой сессии шесть правил, но не пишет файлы контекста. Плагин запускает уже установленный гем, поэтому сначала выполните `gem install rails-ai-context`.
Работает ли гем, если приложение не запускается?
Да, в статическом режиме (флаг `--no-boot`): гем читает маршруты, дамп схемы и исходники. Ответы помечены `[STATIC]`, а данные, зависящие от запуска, `[UNAVAILABLE]`.
Как запустить инструмент без сервера?
Через CLI: `rails-ai-context tool schema --table users --detail full`. В приложении с гемом в `Gemfile` подойдет `bin/rails 'ai:tool[search_code]' pattern="publishable?" match_type=trace`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыDev-движок Rails подключает агента к запущенному приложению: восемь MCP-инструментов и навыки под гемы вашего Gemfile.
Скилл и плагин RubyLLM помогают агенту писать чаты, инструменты, MCP и структурированный вывод в приложениях на Ruby и Rails
MCP-сервер и плагин для агентов генерируют веб-API из спецификаций OpenAPI, AsyncAPI, GraphQL, gRPC и SQL на ядре Rust.
MCP-сервер к AEM Content Manager: агент проверяет и запускает скрипты Groovy на Adobe Experience Manager и читает историю запусков
Плагин навыков строит веб-приложения на Rust по соглашениям Rails: от каркаса и ресурсов до проверки и выкладки.
Бэкенд на PostgreSQL, который агент строит через MCP, а платформа проверяет каждое изменение и умеет откатить.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| rails-ai-context (эта карточка) | нет | не нужна | 186 | |
| Rails MCP Server | да | не нужна | 573 | отдает структуру проекта и документацию Rails; здесь 35 инструментов читают схему, фильтры, фабрики и вызывающие методы вашего приложения |
| Tidewave Rails | да | не нужна | 475 | работает с запущенным Rails для разработки; здесь есть статический режим без загрузки приложения |
Коротко о README
README начинается с промпта для самоустановки: агент ставит гем, выбирает свой инструмент и называет оставшийся шаг. Дальше идут примеры реальных ответов на учебном приложении, справочник инструментов и таблица вариантов установки.