VectorCode MCP
Code indexing for LLMs: VectorCode builds repository search and feeds relevant context to an agent via CLI and MCP
- 874 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Reads and indexes your repository files
- Sets up a local vector database and embedding model
- An external embedding engine, if connected, sends data out
Install
- Works in
Manual install
uv tool install "vectorcode[mcp]<1.0.0"Install with MCP support via uv. Then index the repository with the vectorcode command.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads and indexes your repository files
- Sets up a local vector database and embedding model
- An external embedding engine, if connected, sends data out
This is third-party code. Review the repository files before installing.
What it does
VectorCode indexes a code repository and returns fragments relevant to the current task on demand. This helps build better context for coding LLMs, especially for closed-source and lesser-known projects the model knows little about, and reduces hallucination. It chunks files with syntax awareness via tree-sitter, respects .gitignore and detects the project root by anchors like .git or .vectorcode. It offers a command-line tool, a neovim plugin and an MCP server that wires the context into agents. Storage is built on ChromaDB.
Who it is for. For developers who want to give coding agents accurate context from their repository.
Good fit when
- You want to inject relevant pieces of your code into the prompt
- The agent knows a closed-source or niche project poorly
- You need local code search via RAG without manual copying
Not a fit when
- The project is small enough to fit whole in context
- You cannot set up a local vector database and embedding model
- You need a stable release; the project is beta and changes fast
Example request
Find the code that handles authorization in the indexed repository and add it to contextMCP
- Transport
- stdio
- Authentication
- not required
Limitations
The project is beta and iterates fast, interfaces may change, and the authors suggest pinning a version with a constraint. It needs Python 3.11 or newer, and building ChromaDB components may require recent c++ and rust compilers. By default embeddings run on the local SentenceTransformer model; other engines and acceleration need separate setup. The MCP mode installs an extra dependency group.
How to disable. Remove the server entry from your MCP client config. The tool itself is removed with uv tool uninstall vectorcode.
FAQ
Is it a CLI or an MCP server?
Both. There is a command-line tool for indexing and queries, a neovim plugin and an MCP server that feeds context to agents.
Does data leave your machine?
By default embeddings run on a local model and the index sits in a local ChromaDB database. An external embedding engine is wired in separately.
Discussion
No questions or reviews yet.
Related
MCP serversThe MCP server finds definitions and meaningful code fragments through a local index with vector and full-text search.
A local codebase index for agents: hybrid search, dependency graphs and change impact analysis
An MCP server that indexes a local repository with tree-sitter and gives the agent code search, file lookup and a structure summary of a file
An MCP server and CLI for code research: search and understand your project and all of GitHub with fewer tokens
A semantic code search MCP server: indexes the project into a vector database and gives the agent only relevant snippets
An MCP server that indexes code with tree-sitter and returns individual functions and classes to the agent instead of whole files
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| VectorCode (this card) | no | not required | 874 | |
| kubectl-mcp-server | no | not required | 972 | reads cluster state and diagnoses pod failures |
| Unreal Engine MCP Server | no | not required | 1,033 | Unreal Engine assets, actors and blueprints |
| Android MCP | no | not required | 924 | controls an Android device through ADB |
README in short
The README presents VectorCode as a code repository indexing tool that helps build context for coding LLMs and reduces hallucination on lesser-known projects. It ships a command-line tool, a neovim plugin with an API set and an MCP server. Install is recommended via uv tool install, with extra dependency groups for LSP and MCP modes. It outlines a roadmap: syntax-aware chunking, .gitignore handling, project root anchors and collection deletion. The project is beta, storage is ChromaDB, and it is MIT licensed.