🔍 rails-mcp-insight

Deep Rails introspection MCP server for AI assistants

---

Give your AI assistant (Claude Desktop, Cursor, VS Code / Roo Code / Cline) deep, intelligent understanding of your Ruby on Rails application through the open Model Context Protocol (MCP).

Unlike basic tools that dump raw files or schema definitions, rails-mcp-insight provides cross-referenced, contextual intelligence — tracing the full request lifecycle from route → controller → model → callbacks → background jobs → mailers.

---

✨ Available Tools (15)

Tool	Description	Example Prompt
stats_overview	Project dashboard: versions, counts, LOC, test coverage	"Give me an overview of this Rails project."
search_routes	Smart route search with HTTP method & path filtering	"Find all POST routes in config/routes.rb"
analyze_model	Deep dive: columns, associations, validations, callbacks, scopes	"Analyze the Order model."
analyze_controller	Actions, filters, strong params, rescue handlers	"Show details for OrdersController."
search_code	Regex code search with surrounding context lines	"Search for stripe_customer_id across the codebase."
find_definition	Locate where any class, module, method, or constant is defined	"Where is OrderService defined?"
list_models	List all models with table names & metadata at a glance	"List all models in this application."
trace_request	🔥 Full request lifecycle tracing (killer feature!)	"Trace what happens when POST /orders is called."
analyze_migration_history	Chronological schema evolution & migration timeline	"Show migration history for the users table."
audit_gems	Dependency health check from Gemfile / Gemfile.lock	"Audit our installed gems."
check_security	Static analysis for SQL injection, mass assignment, XSS, etc.	"Scan this project for security vulnerabilities."
find_tests	Map source files → test/spec files + factories	"Find test files for app/models/user.rb"
analyze_job	ActiveJob queue, retry/discard config, callbacks, triggers	"Analyze OrderConfirmationJob."
explain_association_chain	Find all association paths between two models	"How does User relate to Product?"
generate_erd	Mermaid Entity Relationship Diagrams	"Generate an ERD for User, Order, Product."

---

🎯 The Killer Feature: trace_request

Ask your AI: "What happens when a user submits POST /orders?"

rails-mcp-insight traces the full request path statically: