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.
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.
Hosted MCP memory: save sessions/decisions once, search from Claude, Cursor, ChatGPT. EU-hosted FTS.
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-