What it does
semhood is an MCP server and semantic code search tool that parses source with Tree-sitter and indexes every function, method and class as its own chunk, with its signature and docstring attached. Queries are run as a hybrid of dense vectors and BM25 sparse retrieval. It supports Python, JavaScript, TypeScript, Java, Go, PHP, C#, Ruby, Rust and C++. Each result includes what the chunk calls and what calls it, and the get_chunk_context tool returns the body along with these callers and callees in one response.
It suits cases where keyword search misses code, for example when a developer asks how a behaviour is implemented and the source uses terse names or raw logic. An optional enrichment step uses an LLM or a code agent to write a logic summary and predicted developer questions for each chunk, stored as separate vectors. The enrichment is generated once and can be committed to git for the team to share. Incremental indexing with --changed re-indexes only the files touched by git diff. The MCP server is listed as working with Claude Desktop, Cursor, Cline, Continue, Kiro and Zed.
Setup needs Python 3.11 or later. By default it runs offline with a local embedding model and no API keys, and the first index downloads that model, about 420 MB, and caches it. Cloud embeddings from Voyage or OpenAI can be used instead. A background daemon keeps the embedding model loaded between searches. Each project gets its own index under ~/.semhood/indexes, and a single global configuration file is created at ~/.semhood/config.yaml.
Limitations and requirements
Requires Python 3.11 or later. The first indexing run downloads an embedding model of about 420 MB. Cloud embedding options require access to Voyage or OpenAI. LLM enrichment requires an LLM or a code agent.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
semhood
AST-based semantic code search; results ship with their call graph (calls + callers).
v0.1.0As shown on registry.modelcontextprotocol.io when we last read it