Rails-AI-Context Gem: MCPでClaude Codeに完全なモデル提供

概要

rails-ai-context gemは、Claude CodeがRailsアプリケーションを扱う際の制限に対処します。アプリ全体を自動的にイントロスペクションし、その構造をModel Context Protocol（MCP）を通じて公開することで、手動設定なしにClaude CodeがRailsアプリの完全なメンタルモデルを構築できるようにします。

主な詳細

このgemは、Claude CodeがRailsで「多くの推測」をしてしまう特定の問題を解決します。例えば、数千行のschema.rbを読んで1つのカラムを探す、暗号化されたカラムを見落とす、Stimulusの配線を知らない、既存のUIパターンに合わせずに独自のパターンを考案してしまう、といった問題です。

セットアップには、Gemfileへの追加が必要です：

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

そして、ジェネレーターを実行します：

rails generate rails_ai_context:install

Claude Codeは、.mcp.jsonファイルを通じてMCPサーバーを自動的に発見し、手動設定は一切不要です。

このgemは、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は必要な情報を正確にクエリできます：暗号化やNULL許容のヒントを含むスキーマ、モデルの関連付けとスコープ、ルートマップ、StimulusコントローラーとHTMLの配線、Turboのブロードキャストとサブスクリプションのマッピング、実際のデザインシステムパターンなどです。

このgemはまた、CLAUDE.mdファイルと.claude/rules/内のツールごとの分割ファイルを生成するため、MCPがなくてもClaudeはコンテキストを持てます。

CLIフォールバックもあり、同じ39のツールがrails 'ai:tool[schema]'としてあらゆるワークフローで動作します。

このプロジェクトはMITライセンスで、Ruby 3.2以上とRails 7.1以上が必要です。