suhail-ak-2/mcp-typesense-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
Via mcp-get
Development
Install dependencies:
Build the server:
For development with auto-rebuild:
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
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
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/ )
- JSON schema information for each collection
- Includes field names and data types
- Sample documents for understanding data structure
Tools
The server provides the following tools for interacting with Typesense:
- **typesense_list_collections** - List all available collections with their schemas
- Enables zero-conf discovery and routing
- LLM can enumerate collections at runtime and pick the right one(s) before searching
- Useful when collections vary by environment, tenant, or version
- Returns field definitions for schema inference (searchable, facetable, numeric fields)
- Supports include_fields parameter to control detail level
- **typesense_query** - Search for documents in a collection
- Full-text search with customizable parameters
- Supports filtering, sorting, and pagination