qdrant-mcp-local

This is a Docker Compose configuration for easily launching Qdrant and MCP-server-qdrant in a local environment. ## Overview This repository includes the following components: 1. **Qdrant** - Vector search engine 2. **MCP-server-qdrant** - [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server. It supports integration with the Qdrant vector database. ## Setup Instructions ### Prerequisites - Docker - Docker Compose V2 (usually included in current Docker) ### Usage Instructions 1. Clone the repository: ```bash git clone https://github.com/hirokita117/qdrant-mcp-local.git cd qdrant-mcp-local ``` 2. Create a directory for data storage: ```bash mkdir -p data ``` 3. Start the environment using Docker Compose (the first time may take a while to build): ```bash docker compose up -d ``` This will start the following services: - Qdrant: http://localhost:6333 - MCP Server: http://localhost:8000 4. To stop the environment: ```bash docker compose down ``` Data from Qdrant will be stored in the `./data` directory, so the information will be retained even if the container is stopped. ## Customizing Settings You can change environment variables by editing the `.env` file. ## Troubleshooting ### If the container does not start 1. **Run the debug script**: ```bash chmod +x debug.sh ./debug.sh ``` This script will display detailed information about the environment and errors. 2. **Check logs manually**: ```bash docker compose logs mcp-server ``` 3. **Rebuild the container**: To completely rebuild the environment: ```bash docker compose down docker compose build --no-cache docker compose up -d ``` 4. **Common issues and solutions**: - **Port conflict**: If ports 6333 or 8000 are already in use, please specify a different port in the `.env` file. - **Disk space**: Check if there is enough disk space for Docker. - **Docker daemon**: Ensure that the Docker daemon is running properly. For detailed troubleshooting, refer to [docs/USAGE.md](docs/USAGE.md). ## Usage Examples ### MCP Server Endpoints - MCP SSE endpoint: `http://localhost:8000/sse` ### Example Configuration for Claude Desktop When using with Claude Desktop, add the following to `claude_desktop_config.json`: ```json { "mcpServers": { "qdrant": { "command": "curl", "args": ["-N", "http://localhost:8000/sse"], "transport": "sse" } } } ``` ### Example Configuration for Cursor When using with Cursor, specify the following URL in the MCP server settings: ``` http://localhost:8000/sse ``` ## License This project adheres to the licenses of the original Qdrant and MCP-server-qdrant.