MCP server for clean code planning and generation with comprehensive English comments
An MCP server implementation that provides a tool for planning and creating clean, well-structured code with comprehensive English comments.
- Plan code architecture step by step
- Design modular, maintainable components
- Follow clean code principles and best practices
- Create comprehensive documentation with English comments
- Revise design decisions as requirements become clearer
- Branch into alternative implementation strategies
- Focus on code readability and simplicity
Facilitates clean code planning with a focus on readability, maintainability, and well-structured English comments.
Inputs:
- thought (string): Your current code planning step
- nextThoughtNeeded (boolean): Whether another code planning step is needed
- thoughtNumber (integer): Current step number
- totalThoughts (integer): Estimated total steps needed
- isRevision (boolean, optional): Whether this revises a previous planning step
- revisesThought (integer, optional): Which step is being reconsidered
- branchFromThought (integer, optional): Branching point step number for alternative approach
- branchId (string, optional): Alternative implementation identifier
- needsMoreThoughts (boolean, optional): If more planning steps are needed
The Clean Code tool is designed for:
- Before writing complex code that needs careful planning
- When designing new features or refactoring existing code
- When code structure and organization are critical
- For ensuring comprehensive documentation with English comments
- For following clean code principles and best practices
- For breaking down complex functionality into modular components
- For planning testable and maintainable implementations
Add this to your claude_desktop_config.json:
#### npm installation
``json`
{
"mcpServers": {
"cleancode": {
"command": "npx",
"args": [
"-y",
"mcp-clean-code"
]
}
}
}
#### Manual installation
`bashInstall from npm
npm install -g mcp-clean-code
#### PNPM installation
`bash
Install from npm using PNPM
pnpm add -g mcp-clean-codeThen use in configuration
{
"mcpServers": {
"cleancode": {
"command": "mcp-clean-code"
}
}
}
`#### docker
`json
{
"mcpServers": {
"cleancode": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"mcp-clean-code"
]
}
}
}
`Building
Docker:
`bash
docker build -t mcp-clean-code .
`From source:
`bash
Clone the repository
git clone https://github.com/your-username/mcp-clean-code.git
cd mcp-clean-codeInstall dependencies and build
pnpm install
pnpm build
`GitHub Actions CI/CD
This repository includes a GitHub Actions workflow that automatically publishes the package to npm when a new release is created.
$3
To enable automatic publishing to npm, you need to add an NPM_TOKEN secret to your GitHub repository:
1. Generate an npm access token:
- Go to npmjs.com and log in
- Click on your profile picture in the top right corner and select "Access Tokens"
- Click "Generate New Token" and choose the "Publish" option
- Copy the generated token
2. Add the token to your GitHub repository:
- Go to your GitHub repository
- Click on "Settings" > "Secrets and variables" > "Actions"
- Click "New repository secret"
- Name:
NPM_TOKEN`3. Create a new release:
- Go to your GitHub repository
- Click on "Releases" > "Create a new release"
- Choose a tag version (e.g., v1.0.0)
- Add a release title and description
- Click "Publish release"
The GitHub Actions workflow will automatically trigger, build the package, and publish it to npm.
This MCP server is licensed under the MIT License and is developed by Aidalinfo (https://aidalinfo.fr). You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.