MCP server for semantic code search using local 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-search-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 Search MCP Server An MCP server that provides semantic code search using local embeddings. Search your codebase with natural language queries like "authentication middleware" or "database connection pooling". ## Features - **Hybrid search**: Combines vector similarity (Jina code embeddings) with FTS5 keyword matching using Reciprocal Rank Fusion - **165+ languages**: Tree-sitter parsing for Python, TypeScript, JavaScript, Go, Rust, Java, C/C++, Ruby, PHP, and more - **Incremental indexing**: File watcher automatically detects additions, modifications, and deletions - **Respects .gitignore**: Honors your project's `.gitignore` files (including nested ones) - **Auto-initialization**: Model loads and codebase indexes in the background on server startup - **Zero external APIs**: All embeddings generated locally with FastEmbed ## Installation ```bash uv tool install semantic-search-mcp ``` Or with pip: ```bash pip install semantic-search-mcp ``` Or run directly without installing: ```bash uvx semantic-search-mcp ``` ## Quick Start ### Add to Claude Code **Option A: Project-level config (recommended)** After installing with `uv tool install` or `pip install`, create `.mcp.json` in your project root: ```json { "mcpServers": { "semantic-search": { "command": "semantic-search-mcp" } } } ``` **Option B: CLI** ```bash claude mcp add semantic-search -- semantic-search-mcp ``` **Option C: Without installing (ephemeral)** If you prefer not to install, use `uvx` to run in an ephemeral environment: ```json { "mcpServers": { "semantic-search": { "command": "uvx", "args": ["semantic-search-mcp"] } } } ``` ### Use The server auto-initializes on startup. ### Available Tools | Tool | Description | |------|-------------| | `search_code` | Search codebase with natural language | | `get_status` | Get server state, progress, and statistics | | `pause_watcher` | Pause file watching (events discarded) | | `resume_watcher`…
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.