Typesense MCP-Server

Ein Model Context Protocol (MCP) Server, der als Schnittstelle zu Typesense dient.

Installation

Installation über Smithery

Um die Typesense-Server-Integration für Claude Desktop automatisch über Smithery zu installieren:

npx -y @smithery/cli install @avarant/typesense-mcp-server --client claude

Manuelle Installation

Installieren Sie uv

Auf dem Mac können Sie es mit homebrew installieren:

brew install uv

Klonen Sie das Paket:

git clone git@github.com:avarant/typesense-mcp-server.git ~/typesense-mcp-server

Aktualisieren Sie Ihre .cursor/mcp.json zur Verwendung in Cursor:

{
  "mcpServers": {
    "typesense": {
      "command": "uv",
      "args": ["--directory", "~/typesense-mcp-server", "run", "mcp", "run", "main.py"],
      "env": {
        "TYPESENSE_HOST": "",
        "TYPESENSE_PORT": "", 
        "TYPESENSE_PROTOCOL": "",
        "TYPESENSE_API_KEY": ""
      }
    }
  }
}

Related MCP server: Better Qdrant MCP Server

Transporte

Der Server unterstützt zwei MCP-Transporte. STDIO ist der Standard und wird von den meisten Desktop-Clients (Claude Desktop, Cursor usw.) verwendet. Für Remote-Clients, Web-UIs oder zustandslose Tools wie llama.cpp Chat können Sie ihn stattdessen als HTTP SSE-Listener ausführen.

STDIO (Standard)

TYPESENSE_API_KEY=xyz uv run python main.py

HTTP / SSE

Setzen Sie MCP_TRANSPORT=sse (oder übergeben Sie --sse) und überschreiben Sie optional Host/Port:

TYPESENSE_API_KEY=xyz \
MCP_TRANSPORT=sse \
MCP_HOST=0.0.0.0 \
MCP_PORT=8000 \
uv run python main.py

Der Server stellt dann Folgendes bereit:

• GET http://<host>:<port>/sse — SSE-Event-Stream (Clients verbinden sich hier)

• POST http://<host>:<port>/messages/ — JSON-RPC-Nachrichten-Endpunkt

Verfügbare Tools

Der Typesense MCP-Server bietet die folgenden Tools:

Server-Verwaltung

• check_typesense_health - Überprüft den Gesundheitsstatus des konfigurierten Typesense-Servers

• list_collections - Ruft eine Liste aller Sammlungen auf dem Typesense-Server ab

Sammlungsverwaltung

• describe_collection - Ruft das Schema und die Metadaten für eine bestimmte Sammlung ab

• export_collection - Exportiert alle Dokumente aus einer bestimmten Sammlung

• create_collection - Erstellt eine neue Sammlung mit dem bereitgestellten Schema

• delete_collection - Löscht eine bestimmte Sammlung

• truncate_collection - Leert eine Sammlung, indem alle Dokumente gelöscht, aber das Schema beibehalten wird

Dokumentenoperationen

• create_document - Erstellt ein einzelnes neues Dokument in einer bestimmten Sammlung

• upsert_document - Führt ein Upsert (Erstellen oder Aktualisieren) eines einzelnen Dokuments in einer bestimmten Sammlung durch

• index_multiple_documents - Indiziert (erstellt, aktualisiert oder führt Upserts durch) mehrere Dokumente in einem Batch

• delete_document - Löscht ein einzelnes Dokument anhand seiner ID aus einer bestimmten Sammlung

• import_documents_from_csv - Importiert Dokumente aus CSV-Daten in eine Sammlung

Suchfunktionen

• search - Führt eine Stichwortsuche in einer bestimmten Sammlung durch

• vector_search - Führt eine Vektor-Ähnlichkeitssuche in einer bestimmten Sammlung durch