@Leonardocrdso/Clean Code

БесплатноНе проверен

An MCP server that provides 63 Clean Code principles for AI-assisted code review and development.

Описание

An MCP server that provides 63 Clean Code principles for AI-assisted code review and development.

README

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

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

from github.com/leonardocrdso/clean-code-mcp

Установка @Leonardocrdso/Clean Code

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/leonardocrdso/clean-code-mcp

FAQ