About Typesense MCP Server
Typesense MCP Server exposes Typesense collection search to MCP clients looking up documents. It supports search parameters, typo tolerance, filtering, faceting, and pagination.
Key features
- 01Search any Typesense collection
- 02Support Typesense search parameters
- 03Typo-tolerant search
- 04Filtering and faceting
- 05Paginated results
Use cases
- 01Find collection documents by query
- 02Filter search results by field conditions
- 03Browse results across pages
MCP support
It provides MCP clients with a tool for searching Typesense collection documents, configured with a Typesense host, protocol, and API key.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMETypesense 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 inq(required): Search query to find documentsquery_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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.