Typesense

Typesense

MCP server enabling AI models to access and search Typesense collections.

16
Stars
11
Forks
0
Releases

Overview

Typesense MCP Server is a Model Context Protocol (MCP) server implementation that provides AI models with access to Typesense search capabilities. It enables LLMs to discover, search, and analyze data stored in Typesense collections by exposing collection schemas, search tools, and analytical prompts through MCP resources and prompts. The server exposes Collection Schemas via typesense:// collections/<collection>, including collection name, description, and document count, and presents a JSON schema for schema access. It offers tools such as typesense_list_collections for zero-conf discovery of available collections and their schemas; typesense_query for full-text search with filtering, sorting, and pagination; typesense_get_document for retrieving a specific document by ID; and typesense_collection_stats for detailed collection metadata. Prompts like analyze_collection and search_suggestions assist in obtaining schema insights and recommended search strategies. Resource templates (typesense_search and typesense_collection) support constructing search queries and viewing collection details. The server can be installed via npm or mcp-get, supports development workflows, and logs to /tmp/typesense-mcp.log. Claude Desktop configuration guidance is provided for integration.

Details

Owner
suhail-ak-s
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Collection Schema Resources

Expose Typesense collection schemas via typesense:// URIs, with collection name, description, document count, and JSON schema access.

Zero-conf Discovery (typesense_list_collections)

List all available collections with their schemas to enable runtime enumeration and routing for LLMs.

typesense_query

Full-text search with filters, sorting, and pagination; returns matching documents with relevance scores.

typesense_get_document

Retrieve a specific document by ID from a collection; returns complete document data.

typesense_collection_stats

Get collection statistics including metadata, document count, and schema information.

analyze_collection

Prompt to analyze collection structure and contents; outputs insights about schema, data types, and statistics.

search_suggestions

Prompt to generate recommended search strategies based on the collection schema.

Resource Templates (typesense_search, typesense_collection)

Templates for constructing search queries and viewing collection details.

Audience

LLMsEnable LLMs to discover, search, and analyze data in Typesense collections
AI developersIntegrate Typesense-backed search into MCP-enabled AI agents
Data scientistsInspect collection schemas and data for analysis

Tags

MCPTypesensesearchcollectionsschemasLLMtoolspromptstemplatesClaude Desktopzero-conf discovery