Rails-AI-Context Gem은 MCP를 통해 Claude 코드에 완전한 Rails 앱 모델을 제공합니다

이것이 무엇인가요

rails-ai-context 젬은 Rails 애플리케이션과 관련된 Claude Code의 한계를 해결합니다. 전체 앱을 자동으로 내부 검사하고 Model Context Protocol(MCP)을 통해 그 구조를 노출함으로써, 수동 설정 없이 Claude Code가 Rails 앱의 완전한 정신적 모델을 갖추도록 합니다.

주요 세부사항

이 젬은 Claude Code가 Rails에서 "많이 추측하는" 구체적인 문제들을 해결합니다: 하나의 컬럼을 찾기 위해 schema.rb의 수천 줄을 읽거나, 암호화된 컬럼을 놓치거나, Stimulus 연결을 모르거나, 기존 패턴을 따르지 않고 UI 패턴을 만들어내는 문제 등입니다.

설정은 Gemfile에 추가해야 합니다:

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

그리고 생성기를 실행합니다:

rails generate rails_ai_context:install

Claude Code는 .mcp.json 파일을 통해 MCP 서버를 자동으로 발견하며, 수동 설정이 전혀 필요하지 않습니다.

이 젬은 Claude가 직접 호출할 수 있는 39가지 도구를 제공합니다. 예를 들면:

• 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()

모든 파일을 읽는 대신, Claude는 정확히 필요한 것만 질의할 수 있습니다: 암호화 및 nullable 힌트가 있는 스키마, 모델 연관관계와 스코프, 라우트 맵, Stimulus 컨트롤러와 HTML의 연결, Turbo 브로드캐스트와 구독의 매핑, 그리고 실제 디자인 시스템 패턴 등입니다.

이 젬은 또한 CLAUDE.md 파일과 .claude/rules/ 내의 도구별 분할 파일을 생성하여 Claude가 MCP 없이도 컨텍스트를 가질 수 있도록 합니다.

CLI 폴백도 있어, 동일한 39가지 도구가 rails 'ai:tool[schema]'와 같은 형태로 어떤 워크플로우에서도 작동합니다.

이 프로젝트는 MIT 라이선스이며, Ruby 3.2+와 Rails 7.1+가 필요합니다.

누구를 위한 것인가요

수동 파일 읽기나 설정 없이도 더 정확하고 컨텍스트를 인지하는 지원을 원하는, Claude Code를 사용하는 Rails 개발자들을 위한 것입니다.