@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-mcpAdding to Claude Code
claude mcp add clean-code-mcp -- npx @leonardocrdso/clean-code-mcpManual 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 categorycleancode://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 reviewlanguage(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 buildLicense
MIT
