Реализация сервера Model Context Protocol (MCP), которая предоставляет моделям ИИ доступ к возможностям поиска Typesense. Этот сервер позволяет LLM обнаруживать, искать и анализировать данные, хранящиеся в коллекциях Typesense.

Демо

Особенности

###Ресурсы Список и доступ к коллекциям через typesense:// Ури Каждая коллекция имеет имя, описание и количество документов. JSON Mime Type для доступа к схеме

Инструменты

typesense query Поиск документов в коллекциях Typesense с мощной фильтрацией Ввод: текст запроса, название коллекции, поля поиска, фильтры, параметры сортировки, лимит

• Возвращает соответствующие документы с оценками релевантности

typesense get document

• Получить конкретные документы по ID из коллекций Ввод: имя коллекции, ID документа
• возвращает полные данные документа

typesense collection stats Получить статистику о коллекции Typesense

• Вход: название коллекции Возвращает метаданные сбора, количество документов и информацию о схеме

###Быстрые предложения analyze collection Анализ структуры и содержания коллекции

• Вход: название коллекции Результат: понимание схемы, типов данных и статистики

Поиск предложения

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",