Workspace MCP Server

Code knowledge and metadata with live update, knowledge library, semantic and vector searches

Local serverstdioTypeScript

What is the Workspace MCP Server?

Code knowledge and metadata with live update, knowledge library, semantic and vector searches

The short version

Project-scoped vector database for AI assistants, providing hybrid semantic + keyword search with automatic project detection.

  • 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

What it needs from you

  • 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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
searchHybrid semantic + keyword search across indexed content
retrieveDirect document lookup by ID or metadata filter
rulesManage persistent behavioral rules
storeStore content, register projects, save notes
grepExact substring or regex search using FTS5
listList project files and folder structure

How to install the Workspace MCP Server

{
  "mcpServers": {
    "github-com-chrisgve-workspace-qdrant": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "qdrant/qdrant"],
      "env": {
        "QDRANT_URL": "your-value",
        "CLAUDE_CONFIG_DIR": "your-value",
        "QDRANT_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • 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
VariableDescriptionRequired
QDRANT_URLEndpoint or connection string the server talks to.Yes
CLAUDE_CONFIG_DIRFilesystem location the server is allowed to use.Optional
QDRANT_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • “Use Workspace to search.”
  • “Use Workspace to retrieve.”
  • “Use Workspace to rules.”

Frequently asked questions

Code knowledge and metadata with live update, knowledge library, semantic and vector searches Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.