By Clean AI Labs, Inc.

Make your coding
agent faster.

Meaning-aware code search for Claude Code, Cursor, and any MCP client. Not grep.

MIT open source

Compatible with any MCP client
Claude CodeCursorCodexWindsurfAntigravity
Drop-in

Works with any of your agents.

One MCP config and your agent searches by meaning instead of grepping — watch it map a feature across the repo in seconds.

claude code · clean mcp0:00
>

clean · index repo
0 files · 0.0k symbols
authsearch_code("user auth + session handling")
lib/auth/session.ts:140.94
middleware.ts:80.88
pricingsearch_code("pricing / product page")
app/pricing/page.tsx:220.92
billingsearch_code("billing & subscription settings")
app/dashboard/billing/page.tsx:180.90
usagesearch_code("usage metering + plan limits")
lib/usage/meter.ts:330.86
Mapped 4 surfaces to wire — auth, pricing, billing, usage.
missing · api/webhooks/stripe route
Mapped
4 min
grep agent ≈ 12m
0.0k
tokens · vs ~180k
What it does

Built for how agents actually read code.

So your agent spends tokens on the right code, not on grepping.

01

Semantic search

Find code by what it does, not by keyword.

02

Local by default

Everything stays in ~/.clean/. No keys, no telemetry.

03

MCP-native

Drops into any MCP client over stdio. One line of config.

04

Index anything

Point it at a local folder or a public GitHub repo.

05

Tree-sitter parsing

Real AST parsing for Python, JS, and TS — not regex.

06

Call-graph aware

Every result carries its callers and callees.

Choose how you run it

Self-host it free, or let us run it.

Same search either way — your laptop or our cloud.

Open sourceFree · MIT

Runs entirely on your laptop. Indexes stay in ~/.clean/ — no account, no keys.

  • 100% local — nothing leaves your machine
  • Index local folders or public GitHub repos
  • Python 3.10–3.13 · pip install and go
  • Hackable, self-hostable, yours forever
install
git clone https://github.com/cleanmcp/clean-mcp.git
python -m pip install -e ".[dev]"
claude mcp add clean -- python -m clean.local.mcp_server
View on GitHub
CloudHosted

Managed indexing and shared context for your team. Zero setup, always warm.

  • No install — connect your MCP client in one step
  • Team-wide shared index & context sync
  • Background re-indexing keeps repos fresh
  • Org management, API keys, and usage in one dashboard
.mcp.json
{
  "mcpServers": {
    "clean": {
      "command": "npx",
      "args": ["-y", "mcp-remote",
        "https://api.tryclean.ai/mcp/sse",
        "--header", "Authorization:Bearer <key>"]
    }
  }
}
Start free

Give your agent real code search.

Self-host in a minute, or skip setup with the cloud.