Typesense MCP Server

A Model Control Protocol (MCP) server for interacting with Typesense, a fast, typo-tolerant search engine. This server provides a standardized interface for performing searches across any Typesense collection.

Features

• Generic search interface for any Typesense collection
• Support for all Typesense search parameters
• Typo-tolerant search
• Filtering and faceting support
• Pagination

Configuration

The server can be configured using the following environment variables:

• TYPESENSE_HOST: Typesense server host (default: "localhost")
• TYPESENSE_PORT: Typesense server port (default: 8108)
• TYPESENSE_PROTOCOL: Protocol to use (http/https) (default: "http")
• TYPESENSE_API_KEY: Typesense API key (default: "xyz")

Available Tools

typesense_search

Search documents in any Typesense collection.

Parameters:

• collection (required): Name of the Typesense collection to search in
• q (required): Search query to find documents
• query_by (optional): Comma-separated list of fields to search in (default: "*")
• filter_by (optional): Filter expressions (e.g., "field:value", "num_field:>100")
• page (required): Page number for pagination (1-based)
• per_page (required): Number of results per page (default: 10, max: 100)

Development

Prerequisites

• Go 1.23 or later
• Access to a Typesense server

Building

go build -o typesense-mcp-server

Running

./typesense-mcp-server