Typesense MCP Server

A Model Context Protocol (MCP) server implementation that provides AI models with access to Typesense search capabilities. This server enables LLMs to discover, search, and analyze data stored in Typesense collections.

Demo

Features

Resources

List and access collections via typesense:// URIs
Each collection has a name, description, and document count
JSON mime type for schema access

Tools

typesense_query
- Search for documents in Typesense collections with powerful filtering
- Input: Query text, collection name, search fields, filters, sort options, limit
- Returns matching documents with relevance scores
typesense_get_document
- Retrieve specific documents by ID from collections
- Input: Collection name, document ID
- Returns complete document data
typesense_collection_stats
- Get statistics about a Typesense collection
- Input: Collection name
- Returns collection metadata, document count, and schema information

Prompts

analyze_collection
- Analyze collection structure and contents
- Input: Collection name
- Output: Insights about schema, data types, and statistics
search_suggestions
- Get suggestions for effective search queries for a collection
- Input: Collection name
- Output: Recommended search strategies based on collection schema

Installation

Via npm

# Global installation
npm install -g typesense-mcp-server

# Local installation
npm install typesense-mcp-server

Via mcp-get

npx @michaellatman/mcp-get@latest install typesense-mcp-server

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation for Development

Using Claude Desktop

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "typesense": {
      "command": "node",
      "args": [
        "~/typesense-mcp-server/dist/index.js",
        "--host", "your-typesense-host",
        "--port", "8108",
        "--protocol", "http",
        "--api-key", "your-api-key"
      ]
    },
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Components

Resources

The server provides information about Typesense collections:

Collection Schemas (typesense://collections/<collection>)
- JSON schema information for each collection
- Includes field names and data types
- Sample documents for understanding data structure

Resource Templates

The server provides templates for:

typesense_search - Template for constructing Typesense search queries
typesense_collection - Template for viewing Typesense collection details

Usage with Claude Desktop

To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

{
  "mcpServers": {
    "typesense": {
      "command": "npx",
      "args": [
        "-y",
        "typesense-mcp-server",
        "--host", "your-typesense-host",
        "--port", "8108",
        "--protocol", "http",
        "--api-key", "your-api-key"
      ]
    }
  }
}

Logging

The server logs information to a file located at:

/tmp/typesense-mcp.log

This log contains detailed information about server operations, requests, and any errors that occur.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server implementation that enables AI models to discover, search, and analyze data stored in Typesense collections through tools for querying documents, retrieving specific items, and accessing collection statistics.

Related Resources

Reddit Discussion about this server

Related MCP Servers

TxtAi Memory Vector Server
rmtech1
-
security
F
license
-
quality
Model Context Protocol (MCP) server implementation for semantic search and memory management using TxtAI. This server provides a robust API for storing, retrieving, and managing text-based memories with semantic search capabilities. You can use Claude and Cline AI Also
Last updated -
7
Python
Typesense MCP Server
avarant
A
security
A
license
A
quality
A server that enables vector and keyword search capabilities in Typesense databases through the Model Context Protocol, providing tools for collection management, document operations, and search functionality.
Last updated -
14
5
Python
MIT License
Lspace MCP Serverofficial
Lspace-io
A
security
F
license
A
quality
An open-source server implementing the Model Context Protocol (MCP) that enables capturing insights from AI sessions and transforming them into persistent, searchable knowledge accessible across tools.
Last updated -
7
5
TypeScript
Docs-MCP
herring101
A
security
A
license
A
quality
An MCP server that allows users to efficiently search and reference user-configured documents through document listing, grep searching, semantic searching with OpenAI Embeddings, and full document retrieval.
Last updated -
4
3
Python
MIT License

View all related MCP servers

Typesense MCP Server