概览
What is qdrant-mcp-local?
A Docker Compose configuration that launches Qdrant vector search engine and MCP-server-qdrant (a Model Context Protocol server for Qdrant) in a local environment.
How to use qdrant-mcp-local?
Clone the repository, create a data/ directory, then run docker compose up -d. Qdrant is available at http://localhost:6333 and the MCP server at http://localhost:8000. Stop with docker compose down. Configuration can be customized via a .env file.
Key features of qdrant-mcp-local
- Single-command local setup of Qdrant and MCP-server-qdrant
- Persistent vector data stored in
./data/directory - SSE transport endpoint at
http://localhost:8000/sse - Configurable environment variables via
.envfile - Includes debug script for troubleshooting
Use cases of qdrant-mcp-local
- Local development of AI applications requiring vector search
- Testing and prototyping MCP integrations with Qdrant
- Running a self-contained Qdrant + MCP stack for experimentation
- Evaluating Qdrant features without cloud dependencies
FAQ from qdrant-mcp-local
What are the prerequisites?
Docker and Docker Compose V2 are required.
How do I customize the configuration?
Edit the .env file to change environment variables (e.g., port numbers).
Where is vector data stored?
Data is persisted in the ./data/ directory, so it survives container restarts.
What endpoints are exposed?
Qdrant at http://localhost:6333 and the MCP SSE endpoint at http://localhost:8000/sse.
How do I troubleshoot if containers don't start?
Run the debug.sh script, check logs with docker compose logs mcp-server, or rebuild with docker compose build --no-cache. Common issues include port conflicts, insufficient disk space, or a stopped Docker daemon.
