MCP servers, Claude Code plugins, and AI integrations that connect LLMs to your Rails development workflow. Analyze code, access documentation, and coordinate changes across tools.

---

## Available Tools

### MCP Servers

<div class="not-prose mt-8 grid grid-cols-1 gap-4 sm:grid-cols-2">
  <a href="/documentation/ai-tools/rails-mcp-server/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      Rails MCP Server
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Let LLMs analyze models, routes, schemas, and execute Ruby code.
    </p>
  </a>

  <a href="/documentation/ai-tools/nvim-mcp-server/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      Neovim MCP Server
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Read and update Neovim buffers from AI assistants.
    </p>
  </a>
</div>

### Claude Code Plugins

<div class="not-prose mt-8 grid grid-cols-1 gap-4 sm:grid-cols-2">
  <a href="/documentation/ai-tools/rails-simplifier/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      Rails Simplifier
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Code simplification following 37signals patterns and One Person Framework.
    </p>
  </a>

  <a href="/documentation/ai-tools/rails-upgrade-skill/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      Rails Upgrade Assistant
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Generate upgrade guides for Rails 6.0 through 8.1.
    </p>
  </a>

  <a href="/documentation/ai-tools/maquina-ui-standards/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      Maquina UI Standards
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Build consistent UIs with maquina_components.
    </p>
  </a>

  <a href="/documentation/ai-tools/mvp-creator/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      MVP Creator
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Research, plan, and document MVPs for Rails applications.
    </p>
  </a>

  <a href="/documentation/ai-tools/better-stimulus/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      Better Stimulus
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Opinionated StimulusJS best practices from betterstimulus.com.
    </p>
  </a>

  <a href="/documentation/ai-tools/spec-driven-development/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      Spec-Driven Development
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Shape features into specs and hand off to Claude Code.
    </p>
  </a>

  <a href="/documentation/ai-tools/rails-security-auditor/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      Rails Security Auditor
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Severity-grouped security audit reports for Rails 8.0–8.2.
    </p>
  </a>

  <a href="/documentation/ai-tools/rails-hotwire-driver/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      Rails Hotwire Driver
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Drive a running local Rails dev server from the terminal.
    </p>
  </a>

  <a href="/documentation/ai-tools/hotwire-patterns/" class="group relative rounded-2xl border border-zinc-200 p-6 hover:border-[#50B1FD]/50 dark:border-zinc-800 dark:hover:border-[#50B1FD]/50 transition">
    <h3 class="font-sora font-semibold text-zinc-900 dark:text-white group-hover:text-[#50B1FD] transition">
      Hotwire Patterns
    </h3>
    <p class="mt-2 text-sm text-zinc-600 dark:text-zinc-400">
      Deep Hotwire internals, decision frameworks, and debugging.
    </p>
  </a>
</div>

---

## What is MCP?

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

MCP servers expose tools that AI assistants can call:

```
# Example: AI assistant analyzes a Rails model
execute_tool(tool_name: "analyze_models", params: { model_name: "User" })
```

### Supported Clients

- Claude Desktop
- Any MCP-compatible client
- Custom integrations via HTTP/SSE mode

---

## What are Claude Code Plugins?

Claude Code plugins extend Claude's capabilities within your development environment. They can be installed from marketplaces and provide:

- **Agents** — Specialized AI assistants for specific tasks
- **Skills** — Knowledge modules that teach Claude project-specific patterns
- **Commands** — Custom slash commands for workflows

### Installing Plugins

```bash
# Add the marketplace
/plugin marketplace add maquina-app/rails-claude-code

# Install a plugin
/plugin install rails-simplifier@maquina
```

---

## Getting Started

### With MCP Servers

**1. Install an MCP Server**

```bash
gem install rails-mcp-server
```

**2. Configure Your Client**

For Claude Desktop, add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "railsMcpServer": {
      "command": "rails-mcp-server"
    }
  }
}
```

**3. Start Using Tools**

In Claude Desktop, the MCP server tools become available automatically. Ask Claude to:

- "Analyze the User model in my Rails project"
- "Show me the routes for the orders controller"
- "What's the database schema for the products table?"

### With Claude Code Plugins

**1. Add the Marketplace**

```bash
/plugin marketplace add maquina-app/rails-claude-code
```

**2. Install Plugins**

```bash
/plugin install rails-simplifier@maquina
/plugin install rails-upgrade-assistant@maquina
/plugin install maquina-ui-standards@maquina
/plugin install mvp-creator@maquina
/plugin install better-stimulus@maquina
/plugin install spec-driven-development@maquina
/plugin install rails-security-auditor@maquina
/plugin install rails-hotwire-driver@maquina
/plugin install hotwire-patterns@maquina
```

**3. Use the Plugins**

```
> Simplify the recent changes to the bookings controller
> Upgrade my Rails app to 8.1
> Create a users index view with maquina components
```

---

## Architecture

### MCP Communication

MCP servers communicate via JSON-RPC 2.0:

| Mode | Use Case |
|------|----------|
| STDIO | Direct integration with Claude Desktop |
| HTTP/SSE | Web-based clients, remote access |

### Plugin Structure

Claude Code plugins follow a standard structure:

```
plugin-name/
├── agents/           # AI agent definitions
│   └── agent.md
├── skills/           # Knowledge modules
│   └── SKILL.md
├── commands/         # Custom slash commands
│   └── command.md
└── references/       # Documentation
    └── *.md
```

---

## Tool Reference

| Tool | Type | Purpose |
|------|------|---------|
| [Rails MCP Server](/documentation/ai-tools/rails-mcp-server/) | MCP Server | Code analysis and Ruby execution |
| [Neovim MCP Server](/documentation/ai-tools/nvim-mcp-server/) | MCP Server | Editor buffer coordination |
| [Rails Simplifier](/documentation/ai-tools/rails-simplifier/) | Plugin | Code simplification with 37signals patterns |
| [Rails Upgrade Assistant](/documentation/ai-tools/rails-upgrade-skill/) | Plugin | Rails 6.0–8.1 upgrade planning |
| [Maquina UI Standards](/documentation/ai-tools/maquina-ui-standards/) | Plugin | UI component generation |
| [MVP Creator](/documentation/ai-tools/mvp-creator/) | Plugin | MVP research, planning, and documentation |
| [Better Stimulus](/documentation/ai-tools/better-stimulus/) | Plugin | StimulusJS best practices and refactoring |
| [Spec-Driven Development](/documentation/ai-tools/spec-driven-development/) | Plugin | Feature specs, task breakdown, and progress tracking |
| [Rails Security Auditor](/documentation/ai-tools/rails-security-auditor/) | Plugin | Rails 8.0–8.2 security audits with severity grouping |
| [Rails Hotwire Driver](/documentation/ai-tools/rails-hotwire-driver/) | Skill | Drive a running local Rails dev server from the terminal |
| [Hotwire Patterns](/documentation/ai-tools/hotwire-patterns/) | Skill | Deep Hotwire internals, decision frameworks, and debugging |

---

## Team Installation

For consistent tooling across your team, add to `.claude/settings.json`:

```json
{
  "extraKnownMarketplaces": {
    "maquina": {
      "source": {
        "source": "github",
        "repo": "maquina-app/rails-claude-code"
      }
    }
  },
  "enabledPlugins": [
    "rails-simplifier@maquina",
    "rails-upgrade-assistant@maquina",
    "maquina-ui-standards@maquina",
    "mvp-creator@maquina",
    "better-stimulus@maquina",
    "spec-driven-development@maquina",
    "rails-security-auditor@maquina",
    "rails-hotwire-driver@maquina",
    "hotwire-patterns@maquina"
  ]
}
```

Commit this file to your repository. Team members get the same plugins automatically.