rails-ai-context MCP

Гем с MCP-сервером для Rails: агент читает схему, модели, маршруты и тесты приложения и перестает угадывать их по шаблону.

  • 186 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Инструменты читают код и схему приложения, а `query` выполняет чтение из базы разработки.
Все причины и проверки

crisnahine/rails-ai-context

Установка

Ручная установка

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.

MCP-серверШирокий доступ82Звезды репозитория

Скилл и плагин RubyLLM помогают агенту писать чаты, инструменты, MCP и структурированный вывод в приложениях на Ruby и Rails

ПлагинМинимальный доступ4,5 тыс.Звезды репозитория

MCP-сервер и плагин для агентов генерируют веб-API из спецификаций OpenAPI, AsyncAPI, GraphQL, gRPC и SQL на ядре Rust.

MCP-серверРасширенный доступ123Звезды репозитория
Официальный

MCP-сервер к AEM Content Manager: агент проверяет и запускает скрипты Groovy на Adobe Experience Manager и читает историю запусков

MCP-серверШирокий доступ37Звезды репозитория

Плагин навыков строит веб-приложения на Rust по соглашениям Rails: от каркаса и ресурсов до проверки и выкладки.

ПлагинРасширенный доступ53Звезды репозитория
Официальный

Бэкенд на PostgreSQL, который агент строит через MCP, а платформа проверяет каждое изменение и умеет откатить.

MCP-серверРасширенный доступ83Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
rails-ai-context (эта карточка)нетне нужна186
Rails MCP Serverдане нужна573отдает структуру проекта и документацию Rails; здесь 35 инструментов читают схему, фильтры, фабрики и вызывающие методы вашего приложения
Tidewave Railsдане нужна475работает с запущенным Rails для разработки; здесь есть статический режим без загрузки приложения

Коротко о README

README начинается с промпта для самоустановки: агент ставит гем, выбирает свой инструмент и называет оставшийся шаг. Дальше идут примеры реальных ответов на учебном приложении, справочник инструментов и таблица вариантов установки.

Бейдж для README

Сообщить о проблеме