ChrisGVE/workspace-qdrant-mcp

Project-scoped vector database for AI assistants, providing hybrid semantic + keyword search with automatic project detection.
> ### 🚧 v0.2.0 rebuild in progress
>
> **workspace-qdrant-mcp is being rebuilt from the ground up in preparation for v0.2.0** —
> a unified storage model, better search quality, more reliable file watching, and a cleaner
> architecture, with a no-re-index migration for existing users. Once the design is locked
> (targeted early July) we'll open the work to outside contributors. See the
> **Roadmap** for the top-line plan.
Features
- **Hybrid Search** - Combines semantic similarity with keyword matching using Reciprocal Rank Fusion
- **Project Detection** - Automatic Git repository awareness and project-scoped collections
- **7 MCP Tools** - search, retrieve, rules, store, grep, list, embedding
- **Code Intelligence** - Tree-sitter semantic chunking + LSP integration for active projects
- **Code Graph** - Relationship graph with algorithms (PageRank, community detection, betweenness centrality)
- **High-Performance CLI** - Rust-based wqm command-line tool
- **Background Daemon** - memexd for continuous file monitoring and processing
Quick Start
Prerequisites
- **Qdrant** - docker run -d -p 6333:6333 -v qdrant_storage:/qdrant/storage qdrant/qdrant
- **C compiler** - Required for compiling Tree-sitter grammars on first use. Tree-sitter grammars are distributed as C source and compiled locally.
- **macOS**: xcode-select --install (Xcode Command Line Tools)
- **Linux**: apt install build-essential (Debian/Ubuntu) or dnf groupinstall "Development Tools" (Fedora)
- **Windows**: Install Visual Studio Build Tools with C++ workload
- **Clang/LLVM** - Required only to **build memexd from source**, for the LadybugDB C++ core (the default graph backend). Pre-built binaries (Homebrew, release artifacts) do not need it.
- **macOS**: Xcode Command Line Tools include Clang (xcode-select --install)
- **Linux**: apt install clang libclang-dev (Debian/Ubuntu) or dnf install clang (Fedora)
- **Alternative**: build without the C++ toolchain using the SQLite-only backend — cargo build --no-default-features --features sqlite
Install
**Option 1: Homebrew (Recommended — macOS & Linux)**
**Option 2: Pre-built Binaries**
Installs wqm, memexd, and workspace-qdrant-mcp to ~/.local/bin (Linux/macOS) or %LOCALAPPDATA%\wqm\bin (Windows).
**Option 3: Build from Source**
See Installation Reference for detailed instructions and platform-specific notes. For Windows, see the Windows Installation Guide.
Configure MCP
**Claude Desktop** (claude_desktop_config.json):
**Claude Code**:
Verify
CLAUDE.md Integration
Add the following to your project's CLAUDE.md (or your global ~/.claude/CLAUDE.md) so Claude Code uses workspace-qdrant proactively:
MCP Tools
| Tool | Purpose |
|------|---------|
| search | Hybrid semantic + keyword search across indexed content |
| retrieve | Direct document lookup by ID or metadata filter |
| rules | Manage persistent behavioral rules |
| store | Store content, register projects, save notes |
| grep | Exact substring or regex search using FTS5 |
| list | List project files and folder structure |
See MCP Tools Reference for parameters and examples.