Typesense MCP Server

A Model Context Protocol (MCP) Server that interfaces with Typesense

Installation

Installing via Smithery

To install Typesense Server Integration for Claude Desktop automatically via Smithery:

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

Manual Installation

Install uv

On Mac you can install it using homebrew

brew install uv

Clone the package

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

Update your .cursor/mcp.json to use 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: SearXNG Model Context Protocol Server

Transports

The server supports two MCP transports. STDIO is the default and is what most desktop clients (Claude Desktop, Cursor, etc.) use. For remote clients, web UIs, or stateless tools like llama.cpp chat, you can run it as an HTTP SSE listener instead.

STDIO (default)

TYPESENSE_API_KEY=xyz uv run python main.py

HTTP / SSE

Set MCP_TRANSPORT=sse (or pass --sse) and optionally override host/port:

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

The server then exposes:

• GET http://<host>:<port>/sse — SSE event stream (clients connect here)

• POST http://<host>:<port>/messages/ — JSON-RPC message endpoint

Available Tools

The Typesense MCP Server provides the following tools:

Server Management

• check_typesense_health - Checks the health status of the configured Typesense server

• list_collections - Retrieves a list of all collections in the Typesense server

Collection Management

• describe_collection - Retrieves the schema and metadata for a specific collection

• export_collection - Exports all documents from a specific collection

• create_collection - Creates a new collection with the provided schema

• delete_collection - Deletes a specific collection

• truncate_collection - Truncates a collection by deleting all documents but keeping the schema

Document Operations

• create_document - Creates a single new document in a specific collection

• upsert_document - Upserts (creates or updates) a single document in a specific collection

• index_multiple_documents - Indexes (creates, upserts, or updates) multiple documents in a batch

• delete_document - Deletes a single document by its ID from a specific collection

• import_documents_from_csv - Imports documents from CSV data into a collection

Search Capabilities

• search - Performs a keyword search on a specific collection

• vector_search - Performs a vector similarity search on a specific collection