Skip to main content
Glama
ishtiaque05

RuboCop MCP Server

by ishtiaque05

RuboCop MCP Server

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

CI License: MIT

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

Related MCP server: Vale MCP Server

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

Tool

Description

rubocop_lint

Run RuboCop on files with auto-correction support

rubocop_list_cops

List available cops with pagination

rubocop_show_cop

Show detailed cop information

rubocop_auto_gen_config

Generate .rubocop_todo.yml for gradual adoption

rubocop_set_auto_lint

Enable/disable automatic linting reminders

rubocop_get_auto_lint_status

Check auto-lint configuration

See API Reference for complete documentation.

Documentation

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides AI assistants with the ability to lint, validate, and auto-fix Markdown files to ensure compliance with established Markdown standards and best practices.
    6
    MIT
  • A
    license
    A
    quality
    F
    maintenance
    Integrates Vale prose linting into AI coding assistants, enabling users to check text files for style and grammar issues using Vale's powerful linting engine. Provides automated style feedback with smart configuration discovery and rich formatted results.
    3
    18
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI coding assistants like Claude Code to perform real-time code linting and get violation summaries from tools such as ESLint, Stylelint, P3C, and Checkstyle via a local server.
    3
    6 npm
    Apache 2.0