Claude Code

Connect Clean to Claude Code (and Claude Desktop) via MCP — locally over stdio or through the cloud.

The local edition runs as a stdio server that Claude Code launches for you. The simplest way to register it:

claude mcp add clean -- python -m clean.local.mcp_server

Or add a project-scoped .mcp.json next to your code:

{
  "mcpServers": {
    "clean": {
      "command": "python",
      "args": ["-m", "clean.local.mcp_server"]
    }
  }
}

To pin a default repo so searches don't need to name it, append --repo owner/repo to args. Make sure you've installed Clean from source first.

Claude Desktop (local)

Claude Desktop uses the same stdio command form — add the clean entry above to your Claude Desktop MCP config.

Verify

In a Claude Code session:

> List MCP tools

You should see Clean's tools — search_code, expand_result, get_source, get_file_tree, list_repos (plus index_repo and delete_repo on the local edition).

Using Clean in Claude Code

Just describe what you're looking for:

"Find the rate limiting middleware"

"Show me how authentication is handled"

"Search for the payment webhook handler"

Claude Code calls search_code automatically and returns semantically matched functions with call graph context.

Claude Code

Claude Desktop (local)

Verify

Using Clean in Claude Code

On this page