RuboCop MCP Server

A Model Context Protocol (MCP) server that provides RuboCop and Rails linting capabilities to AI assistants like Claude and Cursor.

Features

• RuboCop Integration: Run RuboCop linting with Rails-specific cops

• Auto-correction: Automatically fix style violations

• Smart Pagination: Handle large cop lists efficiently

• Auto-lint Mode: Automatic linting reminders for AI assistants

• Flexible Filtering: Run specific cops or departments

• Gradual Adoption: Generate .rubocop_todo.yml for existing projects

Quick Start

Prerequisites

# Install RuboCop
gem install rubocop rubocop-rails

# Or add to your Rails Gemfile
# gem 'rubocop', require: false
# gem 'rubocop-rails', require: false

Installation

# 1. Clone and build
git clone https://github.com/yourusername/rubocop-mcp.git
cd rubocop-mcp
yarn install && yarn build

# 2. Add to Claude CLI
claude mcp add --transport stdio rubocop -- node $(pwd)/build/index.js

# 3. Verify
claude mcp list

Usage

Start Claude in your Rails project and ask:

Lint app/models/user.rb

Check app/controllers for Rails violations and auto-fix them

List all available Rails cops

That's it! See Installation Guide for detailed setup instructions.

Available Tools

See API Reference for complete documentation.

Documentation

• Installation Guide - Complete installation instructions

• Configuration - Configure for different environments

• Usage Guide - Examples and workflows

• API Reference - Complete tool reference

• Auto-Lint Feature - Automatic linting reminders

• Pagination Guide - Handle large result sets

• Development Guide - Contributing and testing

• Troubleshooting - Common issues and solutions

Project Structure

rubocop-mcp/
├── src/              # TypeScript source code
├── build/            # Compiled JavaScript
├── docs/             # Documentation
├── examples/         # Configuration examples
├── test/             # Test files
└── package.json      # Project configuration

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT

Support

• GitHub Issues

• RuboCop Documentation

• MCP Protocol