MCP server: semantic code search with SQLite + local free embeddings
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"semantic-code-index-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# semantic-code-index-mcp MCP server for Claude Code: semantic code search with SQLite + local embeddings (free, no API key needed). Instead of reading your entire codebase, Claude searches semantically — finding relevant code by meaning, not just keywords. Saves 80-90% tokens per query. ## Quick Install (npx) ```bash cd /path/to/your/project npx semantic-code-index-mcp install ``` This automatically: - Creates `.claude/mcp.json` and `.mcp.json` (merged with existing config) - Adds `.claude/rules/semantic-search.md` so Claude prefers semantic search - Updates `.gitignore` Requires Python 3.11+ and [uv](https://docs.astral.sh/uv/) (`brew install uv` or `pip install uv`). ### Uninstall ```bash npx semantic-code-index-mcp uninstall ``` Cleanly removes all config. If you have other MCP servers configured, they are preserved. ## Install from source (dev) ```bash git clone https://github.com/thinhdo/semantic-code-index-mcp cd semantic-code-index-mcp python3 -m venv .venv source .venv/bin/activate pip install -e . # Install into a project using local binary semantic-code-index-mcp install /path/to/your/project # Or via npx with --local flag npx semantic-code-index-mcp install /path/to/project --local .venv/bin/semantic-code-index-mcp ``` ## Usage Once installed, open Claude Code in your project. First time, ask Claude: > Index this project After that, Claude will automatically use `semantic_search` for code exploration. The index auto-syncs when files change — no manual steps needed. ## Tools | Tool | Description | |------|-------------| | `index_project` | Full re-index of the codebase | | `sync_index` | Incremental sync (new/changed/deleted files only) | | `semantic_search` | Hybrid search: semantic vectors + keyword BM25. Auto-syncs before searching | | `list_indexed_files` | List all indexed files with token count and chunk count | | `get_file_chunks` | Get full content of a file's indexed chunks | | `token_usage_stats` | Compare: tokens if reading …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.