A Gema Rails-AI-Context Fornece ao Claude Código com o Modelo Completo do App Rails via MCP

O Que É Isso

A gem rails-ai-context aborda as limitações do Claude Code com aplicações Rails ao realizar automaticamente a introspecção completa do app e expor sua estrutura através do Model Context Protocol (MCP). Isso dá ao Claude Code um modelo mental completo do app Rails sem configuração manual.

Detalhes Principais

A gem resolve problemas específicos onde o Claude Code "adivinha muito" com Rails: ler milhares de linhas no schema.rb para encontrar uma coluna, não detectar colunas criptografadas, não conhecer a configuração Stimulus e inventar padrões de UI em vez de corresponder aos existentes.

A configuração requer adicionar ao Gemfile:

gem "rails-ai-context", group: :development

E executar o gerador:

rails generate rails_ai_context:install

O Claude Code descobre automaticamente o servidor MCP através de um arquivo .mcp.json sem configuração manual.

A gem fornece 39 ferramentas que o Claude pode chamar diretamente, incluindo:

• rails_get_schema(table: "users")
• rails_search_code(pattern: "can_cook?", match_type: "trace")
• rails_validate(files: ["app/models/user.rb"])
• rails_analyze_feature(feature: "billing")
• rails_get_stimulus()
• rails_get_turbo_map()

Em vez de ler cada arquivo, o Claude pode consultar exatamente o que precisa: esquema com dicas de criptografia e nulidade, associações e escopos de modelos, mapas de rotas, configuração de controladores Stimulus para HTML, mapeamento de transmissão Turbo para assinatura e padrões reais do sistema de design.

A gem também gera um arquivo CLAUDE.md e arquivos divididos .claude/rules/ por ferramenta para que o Claude tenha contexto mesmo sem MCP.

Há um fallback CLI onde as mesmas 39 ferramentas funcionam como rails 'ai:tool[schema]' para qualquer fluxo de trabalho.

O projeto tem licença MIT e requer Ruby 3.2+ e Rails 7.1+.

Para Quem É

Desenvolvedores Rails que usam Claude Code e querem assistência mais precisa e contextualizada sem leitura manual de arquivos ou configuração.