Skip to main content
Glama
Abernaughty

code-vector-sync

by Abernaughty

code-vector-sync

An MCP (Model Context Protocol) server that provides semantic code search over a local codebase using Qdrant vector embeddings and OpenAI embeddings. Point it at a directory and query it with natural language from any MCP-compatible client (e.g., Claude Desktop).

What It Does

  • Watches a local directory for file changes and auto-indexes them

  • Embeds code using OpenAI's embedding API

  • Stores vectors in a Qdrant cloud collection

  • Serves semantic search results via the MCP protocol

Related MCP server: Arda Vector Database MCP Server

Architecture

File Watcher → Embedding Service → Qdrant Manager
                                        ↑
MCP Client (Claude) ←── MCP Server ────┘
                         (code_search)

Setup

1. Install dependencies

pip install -r requirements.txt

2. Configure environment

cp .env.example .env
# Edit .env with your Qdrant URL, Qdrant API key, OpenAI API key, and watch directory

3. Run the MCP server

python run_mcp_server.py

4. Connect to Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "code-vector-search": {
      "command": "python",
      "args": ["/path/to/code-vector-sync/run_mcp_server.py"],
      "env": {
        "QDRANT_URL": "your-qdrant-url",
        "QDRANT_API_KEY": "your-api-key",
        "OPENAI_API_KEY": "your-openai-key"
      }
    }
  }
}

Project Structure

code-vector-sync/
├── src/
│   ├── mcp_server.py        # MCP server entry point and tool definitions
│   ├── code_search.py       # Search query handling
│   ├── code_sync_service.py # Orchestrates watching, embedding, and indexing
│   ├── embedding_service.py # OpenAI embedding calls
│   ├── file_watcher.py      # Watchdog-based directory monitoring
│   └── qdrant_manager.py    # Qdrant client and collection management
├── run_mcp_server.py        # Launcher script
├── requirements.txt
├── .env.example             # Template — copy to .env and fill in values
└── .gitignore

Requirements

  • Python 3.10+

  • Qdrant Cloud account (free tier works)

  • OpenAI API key

  • agent-dev — Containerized AI agent dev environment that this server is designed to complement

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables semantic code search across codebases using Qdrant vector database and OpenAI embeddings, allowing users to find code by meaning rather than just keywords through natural language queries.
    2
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables indexing and semantic search of codebases and documents via MCP, using Ollama embeddings and Qdrant vector store.
    5
    Apache 2.0