Qdrant MCP Local

🚀 Qdrant-MCP-Local

Easily launch a Docker Compose setup for Qdrant and MCP-server-qdrant in a local environment.

🚀 Quick Start

This repository provides a convenient way to set up Qdrant and MCP-server-qdrant in a local environment using Docker Compose.

✨ Features

This repository includes the following components:

1. Qdrant - A vector search engine.
2. MCP-server-qdrant - A Model Context Protocol (MCP) server that supports integration with the Qdrant vector database.

📦 Installation

Prerequisites

• Docker
• Docker Compose V2 (usually included with Docker)

Steps

1. Clone the repository:

git clone https://github.com/hirokita117/qdrant-mcp-local.git
cd qdrant-mcp-local

2. Create a data storage directory:

mkdir -p data

3. Start the environment using Docker Compose (the first build may take a little time):

docker compose up -d

This will start the following services:

• Qdrant: http://localhost:6333
• MCP Server: http://localhost:8000

4. Stop the environment:

docker compose down

Qdrant's data is stored in the ./data directory, so the information will be retained even if the container is stopped.

Customization

You can modify the environment variables by editing the .env file.

🔧 Troubleshooting

When the container fails to start

1. Run the debug script:

chmod +x debug.sh
./debug.sh

This script will display detailed environment information and error details.

2. Manually view the logs:

docker compose logs mcp-server

3. Rebuild the container:

To completely rebuild:

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, specify other ports in the .env file.
• Disk space: Ensure that there is sufficient disk space for Docker to use.
• Docker daemon: Confirm that the Docker daemon is running properly.

For detailed troubleshooting information, please refer to docs/USAGE.md.

💻 Usage Examples

MCP Server Endpoints

• MCP SSE Endpoint: http://localhost:8000/sse

Example Setup in Claude Desktop

When using in Claude Desktop, add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "qdrant": {
      "command": "curl",
      "args": ["-N", "http://localhost:8000/sse"],
      "transport": "sse"
    }
  }
}

Example Setup in Cursor

When using in Cursor, specify the following URL in the MCP server settings:

http://localhost:8000/sse

📄 License

This project follows the original licenses of Qdrant and MCP-server-qdrant.