rails-mcp-server

MCP.Pizza Chef: maquina-app

Point it at one or more Ruby on Rails apps on your computer and the assistant gets a guided tour: browsing the file tree, listing which web addresses the app answers, inspecting models and how they relate, matching views to controllers, and reading environment settings. It also bundles the official Rails, Turbo, Stimulus, and Kamal documentation so answers stay grounded in the real thing. Installing it takes Ruby and one terminal command, after which an interactive setup tool can wire up Claude Desktop for you.

Coding

Use This MCP server To

Ask which pages a Rails app actually serves Get a plain explanation of how two models relate See the database tables and columns in a project Find which view a given controller renders Look up official Rails documentation without leaving the chat Switch between several Rails projects in one session

README

Rails MCP Server

A Ruby implementation of a Model Context Protocol (MCP) server for Rails projects. This server allows LLMs (Large Language Models) to interact with Rails projects through the Model Context Protocol, providing capabilities for code analysis, exploration, and development assistance.

What is MCP?

The Model Context Protocol (MCP) is a standardized way for AI models to interact with their environment. It defines a structured method for models to request and use tools, access resources, and maintain context during interactions.

This Rails MCP Server implements the MCP specification to give AI models access to Rails projects for code analysis, exploration, and assistance.

Features

  • Manage multiple Rails projects
  • Browse project files and structures
  • View Rails routes with filtering options
  • Inspect model information and relationships (with Prism static analysis)
  • Get database schema information
  • Analyze controller-view relationships
  • Analyze environment configurations
  • Access comprehensive Rails, Turbo, Stimulus, and Kamal documentation
  • Context-efficient architecture with progressive tool discovery
  • Seamless integration with LLM clients

Installation

Install the gem:

gem install rails-mcp-server

After installation, the following executables will be available in your PATH:

  • rails-mcp-server - The MCP server itself
  • rails-mcp-config - Interactive configuration tool (recommended)
  • rails-mcp-setup-claude - Legacy Claude Desktop setup script
  • rails-mcp-server-download-resources - Legacy resource download script

Configuration

Using the Configuration Tool (Recommended)

The easiest way to configure the Rails MCP Server is using the interactive configuration tool:

rails-mcp-config

This provides a user-friendly TUI (Terminal User Interface) for:

rails-mcp-server FAQ

Which apps does it work in?
Claude Desktop can be configured automatically, and other MCP-capable apps work over a local connection.
Do I need a key or subscription?
No. It reads projects sitting on your own computer and needs no account at all.
How hard is the setup?
You need Ruby installed and one terminal command to add the gem. An interactive tool then walks you through the rest.
Can I use this to understand a Rails codebase I just inherited?
Yes — it can walk the file tree, list the routes, and explain how the models connect to each other.
Does it handle more than one project?
Yes. You register several projects and switch between them by name.
Can it change my code?
The available tools are built for reading and analysing a project, not editing it.
Is it still being maintained?
Yes. The project was still receiving updates in August 2026.