code-vector-sync
Provides code embedding using OpenAI's embedding API for semantic code search.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@code-vector-syncFind code that handles user authentication"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.txt2. Configure environment
cp .env.example .env
# Edit .env with your Qdrant URL, Qdrant API key, OpenAI API key, and watch directory3. Run the MCP server
python run_mcp_server.py4. 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
└── .gitignoreRequirements
Python 3.10+
Qdrant Cloud account (free tier works)
OpenAI API key
Related Projects
agent-dev — Containerized AI agent dev environment that this server is designed to complement
This server cannot be deployed
Maintenance
Related MCP Connectors
Private persistent memory for Claude, ChatGPT & Gemini via MCP - semantic search, zero-code setup.
The Needle MCP server enables semantic search on documents stored in files like PDFs, DOCX, and XLSX by connecting AI applications to external data sources. It provides capabilities to create and manage document collections, perform natural language searches on stored content, and retrieve relevant information without requiring exact keyword matches.
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Project memory, semantic code search, and grounded agent context.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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.2MIT
- FlicenseNot gradedqualityDmaintenanceEnables semantic code search across multi-language codebases using natural language queries, integrated with Qdrant vector database for fast, cached retrieval.1-
- AlicenseAqualityCmaintenanceEnables indexing and semantic search of codebases and documents via MCP, using Ollama embeddings and Qdrant vector store.5Apache 2.0
- FlicenseAqualityDmaintenanceProvides semantic vector search over local codebases via MCP, enabling hybrid search (dense + sparse + RRF) for any MCP client like GitHub Copilot or Claude Desktop.58-