searchLABSCO SUMMARY
Storing is half the point, not an afterthought.
Most code-search servers only read. Here the write path is the design: findings, design rationale and research go into a scratchpad that later sessions — and sub-agents, which start with no history at all — can search semantically. The README ships the CLAUDE.md text to make an assistant use it that way, including the three-step habit of searching first, falling back to plain file tools second, and storing what was learned at the end. Note the rebuild in progress before you commit a large index to it.
What it is
A Qdrant-backed search layer with automatic Git project detection, a Rust daemon doing the file watching and embedding, and a Rust CLI for operations. Search combines semantic similarity with keyword matching using Reciprocal Rank Fusion; code is chunked with Tree-sitter and enriched with LSP data for active projects.
What you get
- Hybrid semantic and keyword search across indexed content, plus exact substring and regex search over FTS5 —
search,grep - Direct document lookup by id or metadata filter, and file and folder listing for exploring project structure —
retrieve,list - A write path: store content, register projects, and save notes so findings survive the session —
store - Persistent behavioural rules that load back into context at the start of a session —
rules - Four collections with different scopes: indexed project code, a library of external reference docs, a scratchpad for analysis and design rationale, and the rules themselves
- A code relationship graph with PageRank, community detection and betweenness centrality, queried from the CLI
- A background daemon that watches files continuously, so the index tracks the working tree without manual re-ingestion
Requirements
- A running Qdrant reachable at
QDRANT_URL— the README's one-liner starts theqdrant/qdrantimage on port 6333 with a storage volume. - The server has to be built from source: clone the repository and run
./install.sh, which compiles it and copieswqm,memexdandworkspace-qdrant-mcpinto~/.local/bin, so that folder needs to be on your PATH. The README's Homebrew and download-script options do not currently deliver the server itself. - The build needs the Rust toolchain (
cargo). - A C compiler, because Tree-sitter grammars ship as C source and are compiled locally — Xcode Command Line Tools on macOS, build-essential on Debian or Ubuntu.
- Clang and LLVM for the daemon, unless you build it with the SQLite-only option the README describes.
QDRANT_API_KEYis needed for Qdrant Cloud, andFASTEMBED_MODELselects the embedding model.- Apache 2.0 licensed, and a v0.2.0 rebuild is in progress.
Setup effort
Build from source — git clone https://github.com/ChrisGVE/workspace-qdrant-mcp.git
USE CASES
Getting oriented in an unfamiliar codebase
Search semantically for the subsystem, list the surrounding structure, and retrieve the documents the search points at — faster than walking files by hand.
Not losing what you worked out last session
Store the analysis and the reasoning in the scratchpad, then retrieve it by meaning rather than by remembering a filename.
Finding an exact symbol or string
Use the regex and substring search when you know the token, and keep semantic search for when you only know the intent.
Searching your reference docs alongside the code
Store external API specs and third-party documentation into the libraries collection and include them in searches.
Keeping behavioural rules across sessions
List the active rules at session start so preferences persist instead of being restated every time.
7 tools
Listed in project docs. Your client may show a different list.
retrieverulesstoregreplistembeddingBEFORE YOU INSTALL
What to know first
Tools you get
7 tools named in the project's documentation.
Requires
- Qdrant running on localhost:6333 — docker run -d -p 6333:6333 -v qdrant_storage:/qdrant/storage qdrant/qdrant
- A Rust toolchain (cargo) — install.sh builds the binaries with cargo and stops without it
- A C compiler, for the Tree-sitter grammars compiled on first use
- Clang/LLVM, for the memexd daemon built from source
- ~/.local/bin on PATH — install.sh puts workspace-qdrant-mcp there by default, and the client blocks launch it by name
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
git clone https://github.com/ChrisGVE/workspace-qdrant-mcp.git
cd workspace-qdrant-mcp
./install.shMCP Clients
Claude Desktop
{
"mcpServers": {
"workspace-qdrant-mcp": {
"command": "workspace-qdrant-mcp",
"env": {
"QDRANT_URL": "http://localhost:6333"
}
}
}
}Claude Code
claude mcp add workspace-qdrant-mcp -- workspace-qdrant-mcp