# CodeClone MCP server

> Provides deterministic structural analysis and change control for AI agents to manage Python code modifications and prevent regressions.

- Repository: https://github.com/orenlab/codeclone
- Page: https://hostedmcp.org/servers/orenlab/codeclone
- Transport: stdio
- Stars: 12
- License: MPL-2.0
- Latest version: 2.0.3

## Install

### Claude Code

```sh
claude mcp add codeclone -- uvx codeclone
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "codeclone": {
      "command": "uvx",
      "args": [
        "codeclone"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "codeclone": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "codeclone"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "codeclone": {
      "command": "uvx",
      "args": [
        "codeclone"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.codeclone]
command = "uvx"
args = ["codeclone"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "codeclone": {
      "command": "uvx",
      "args": [
        "codeclone"
      ]
    }
  }
}
```

## FAQ

### Does CodeClone rewrite my source code?

No, CodeClone does not generate or rewrite source files; it acts as a controller and analysis layer.

### How does CodeClone handle existing technical debt?

It uses a baseline-aware governance system that records accepted legacy debt to separate it from new regressions introduced by current changes.

### Can I use CodeClone in my CI/CD pipeline?

Yes, it can be used in GitHub Actions to reject newly introduced clones, metric regressions, API breaks, and coverage regressions.

### Does CodeClone require a cloud account?

No, it is a local-first tool that requires no hosted service or cloud account.
