CodeClone — Claude Code MCP server: analysis and setup
CodeClone maps structural issues in Python repositories and compares them with a saved baseline. Use it to review new regressions separately from existing debt.
MPL-2.0 ★ 12 updated 2026-10-28
claude mcp add codeclone -- uvx codecloneWhat CodeClone does
The MCP server exposes repository analysis covering code clones, complexity, module relationships, dead code, and public APIs. CodeClone can render the same report as JSON, HTML, Markdown, or SARIF. It does not edit source files or ask an LLM to judge whether a change is safe; its findings come from repository analysis.
A baseline records structural debt the team has already accepted, so later checks can focus on regressions from the current change. The baseline file is codeclone.baseline.json; update it deliberately and commit it, rather than changing it just to clear a failed check. Python 3.10 or newer is required. MCP change control and related features are marked alpha in CodeClone 2.1.
What it helps with
- locate duplicated code and high-complexity areas in a Python repository
- separate newly introduced regressions from existing structural debt
- inspect module dependencies and dependency cycles
- review public APIs and dead code in one analysis
Example prompts for the agent
- Analyze this Python repository and report its structural findings.
- Compare the current analysis with the baseline and identify regressions from this change.
- Show the module dependency structure and the main code duplication findings.
How to install CodeClone
Platform CLI
claude mcp add codeclone -- uvx codecloneuvx runs the command named after the package; if the README names another one, use uvx --from codeclone <command>
Platform CLI
codex mcp add codeclone -- uvx codecloneuvx runs the command named after the package; if the README names another one, use uvx --from codeclone <command>
Config file
{
"mcpServers": {
"codeclone": {
"command": "uvx",
"args": [
"codeclone"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from codeclone <command>
Config file
{
"servers": {
"codeclone": {
"type": "stdio",
"command": "uvx",
"args": [
"codeclone"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from codeclone <command>
Platform CLI
gemini mcp add codeclone uvx codecloneuvx runs the command named after the package; if the README names another one, use uvx --from codeclone <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about CodeClone
How do I install CodeClone in Claude Code?
Run claude mcp add codeclone -- uvx codeclone. Python 3.10 or newer is required.
What does CodeClone do?
It analyzes Python repository structure and reports on clones, complexity, module relationships, dead code, and public APIs. A saved baseline helps distinguish new regressions from existing issues.
What is the CodeClone baseline for?
It stores structural debt that has already been accepted. Later analysis can then highlight regressions introduced by the current change.