Servidor MCP de Typesense

Un servidor de Protocolo de Contexto de Modelo (MCP) que se conecta con Typesense

Instalación

Instalación a través de Smithery

Para instalar la integración del servidor Typesense para Claude Desktop automáticamente a través de Smithery:

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

Instalación manual

Instale uv

En Mac puede instalarlo usando homebrew

brew install uv

Clone el paquete

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

Actualice su .cursor/mcp.json para usarlo en 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

Transportes

El servidor admite dos transportes MCP. STDIO es el predeterminado y es el que utilizan la mayoría de los clientes de escritorio (Claude Desktop, Cursor, etc.). Para clientes remotos, interfaces web o herramientas sin estado como el chat de llama.cpp, puede ejecutarlo como un oyente HTTP SSE en su lugar.

STDIO (predeterminado)

TYPESENSE_API_KEY=xyz uv run python main.py

HTTP / SSE

Establezca MCP_TRANSPORT=sse (o pase --sse) y opcionalmente sobrescriba el host/puerto:

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

El servidor entonces expone:

• GET http://<host>:<port>/sse — Flujo de eventos SSE (los clientes se conectan aquí)

• POST http://<host>:<port>/messages/ — Punto final de mensajes JSON-RPC

Herramientas disponibles

El servidor MCP de Typesense proporciona las siguientes herramientas:

Gestión del servidor

• check_typesense_health - Comprueba el estado de salud del servidor Typesense configurado

• list_collections - Recupera una lista de todas las colecciones en el servidor Typesense

Gestión de colecciones

• describe_collection - Recupera el esquema y los metadatos de una colección específica

• export_collection - Exporta todos los documentos de una colección específica

• create_collection - Crea una nueva colección con el esquema proporcionado

• delete_collection - Elimina una colección específica

• truncate_collection - Trunca una colección eliminando todos los documentos pero manteniendo el esquema

Operaciones de documentos

• create_document - Crea un único documento nuevo en una colección específica

• upsert_document - Realiza un upsert (crea o actualiza) de un único documento en una colección específica

• index_multiple_documents - Indexa (crea, realiza upsert o actualiza) múltiples documentos en un lote

• delete_document - Elimina un único documento por su ID de una colección específica

• import_documents_from_csv - Importa documentos desde datos CSV a una colección

Capacidades de búsqueda

• search - Realiza una búsqueda por palabras clave en una colección específica

• vector_search - Realiza una búsqueda de similitud vectorial en una colección específica