What is Typesense Mcp Server

The typesense-mcp-server is a Model Context Protocol (MCP) server that interfaces with Typesense, a powerful search engine designed for speed and relevance.

Use cases

Use cases include managing product catalogs in e-commerce, searching through large datasets in analytics applications, and providing search functionalities in content management systems.

How to use

To use typesense-mcp-server, install the required tools, clone the repository, and configure the MCP server settings in your .cursor/mcp.json file, specifying the Typesense server details.

Key features

Key features include server management tools for checking health status, listing collections, and managing documents such as creating, updating, and deleting documents and collections.

Where to use

typesense-mcp-server can be used in various fields that require fast and efficient search capabilities, such as e-commerce, content management systems, and data analytics.

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 [email protected]: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": ""
      }
    }
  }
}

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