qdrant-mcp-server v1.0.1

Qdrant MCP Server

Een Model Context Protocol (MCP) server voor interactie met een lokale Qdrant vectordatabase.

Vereisten

• Node.js (v16 of hoger)
• npm
• Docker (met draaiende Qdrant container)

Installatie

1. Clone dit repository
2. Installeer de dependencies:

npm install

Qdrant opstarten (al gedaan in jouw geval)

Zorg ervoor dat je een Qdrant container draait op poort 6333, zoals:

docker run -p 6333:6333 -p 6334:6334 \
    -v "$(pwd)/qdrant_storage:/qdrant/storage:z" \
    qdrant/qdrant

MCP Server starten

Je kunt de server starten op verschillende manieren, afhankelijk van de gewenste transport methode:

Voor SSE (aanbevolen voor Cursor)

npm run start:sse

Voor stdio (CLI mode)

npm run start:stdio

Voor standaard HTTP API

npm run start

Je kunt nu verbinding maken met de MCP server via:

• HTTP API: http://localhost:3000
• SSE Endpoint (voor Cursor): http://localhost:3000/sse

Gebruik met Cursor

Om deze MCP server te gebruiken met Cursor:

1. Open Cursor en ga naar Settings > Features > MCP
2. Klik op de "Add New MCP Server" knop
3. Vul de volgende gegevens in:
   • Name: Qdrant MCP
   • Type: SSE
   • URL: http://localhost:3000/sse
4. Klik op "Save"

Je kunt de MCP tools nu gebruiken in de Cursor Composer door de Agent vragen te stellen over Qdrant vectordatabases.

Beschikbare tools

De server biedt de volgende tools:

1. create_collection

Maak een nieuwe collectie aan in Qdrant.

Vereiste parameters:

• collection_name: Naam van de collection om aan te maken
• vector_size: Grootte van de vectoren in deze collectie
• distance: Afstandsmetriek voor de vectoren ('cosine', 'euclid', 'dot')

2. add_vector

Voeg een vector toe aan een bestaande collectie.

Vereiste parameters:

• collection_name: Naam van de collection om vectoren aan toe te voegen
• id: ID voor de vector
• vector: De vector data (array van getallen)
• payload: Extra data bij de vector (optioneel)

3. search

Zoek naar vectoren in een collectie.

Vereiste parameters:

• collection_name: Naam van de collection om in te zoeken
• vector: Query vector om te zoeken
• limit: Aantal resultaten (standaard 10)
• score_threshold: Minimum score voor resultaten (optioneel)
• filter: Filter query voor de zoekactie (optioneel)

4. list_collections

Toon alle beschikbare collecties.

Geen verplichte parameters.

5. batch_upload

Voeg meerdere vectoren tegelijk toe aan een collectie.

Vereiste parameters:

• collection_name: Naam van de collection om vectoren aan toe te voegen
• vectors: Array van vectoren om toe te voegen, elk met:
  • id: ID voor de vector
  • vector: De vector data
  • payload: Extra data bij de vector (optioneel)

6. delete_vectors

Verwijder vectoren uit een collectie.

Vereiste parameters:

• collection_name: Naam van de collection om vectoren uit te verwijderen
• ids: Array van IDs van de vectoren om te verwijderen

7. get_collection_info

Haal informatie op over een specifieke collectie.

Vereiste parameters:

• collection_name: Naam van de collection om informatie over op te halen

Voorbeeld gebruik

Je kunt de MCP server gebruiken met elke client die het Model Context Protocol ondersteunt. Zie de lijst van MCP clients voor meer informatie.