@leonardocrdso/clean-code-mcp

An MCP (Model Context Protocol) server that provides 63 Clean Code principles for AI-assisted code review and development. Search, browse, and review code against best practices from Robert C. Martin's Clean Code.

Installation

Using npx (recommended)

npx @leonardocrdso/clean-code-mcp

Adding to Claude Code

claude mcp add clean-code-mcp -- npx @leonardocrdso/clean-code-mcp

Manual configuration

Add to your MCP client settings:

{
  "mcpServers": {
    "clean-code-mcp": {
      "command": "npx",
      "args": ["@leonardocrdso/clean-code-mcp"]
    }
  }
}

Tools

search-principle

Search principles by name, keyword, or ID. Returns detailed results for top matches and a summary for additional matches.

query: "srp"
query: "naming"
query: "keep-functions-small"

search-by-context

Find relevant principles for a given situation. Describe your problem in natural language.

context: "my function has too many parameters and is hard to test"
context: "I have deeply nested if statements"

list-principles

List all principles or filter by category.

category: "solid"
category: "error-handling"

Resources

• cleancode://catalog — Full catalog of all 63 principles grouped by category
• cleancode://principle/{id} — Individual principle by ID

Prompts

clean-code-review

Generates a structured code review prompt with relevant Clean Code principles embedded as context.

Parameters:

• code (required) — The source code to review
• language (optional) — Programming language (e.g. typescript, python)
• focus_categories (optional) — Comma-separated categories to focus on

Categories

13 categories covering 63 principles:

| Category | Description | |---|---| | naming | Meaningful Names | | functions | Functions | | comments | Comments | | formatting | Formatting | | error-handling | Error Handling | | unit-testing | Unit Testing | | classes | Classes | | solid | SOLID Principles | | code-smells | Code Smells | | objects-and-data-structures | Objects and Data Structures | | concurrency | Concurrency | | systems | Systems | | emergence | Emergence |

Development

# Install dependencies
bun install

# Run in development mode
bun run dev

# Build
bun run build

License

MIT