Typesense MCP Server

Сервер Model Context Protocol (MCP), который взаимодействует с Typesense

Установка

Установка через Smithery

Чтобы автоматически установить интеграцию Typesense Server для Claude Desktop через Smithery:

npx -y @smithery/cli install @avarant/typesense-mcp-server --client claude

Ручная установка

Установите uv

На Mac вы можете установить его с помощью homebrew

brew install uv

Клонируйте пакет

git clone git@github.com:avarant/typesense-mcp-server.git ~/typesense-mcp-server

Обновите ваш .cursor/mcp.json для использования в Cursor

{
  "mcpServers": {
    "typesense": {
      "command": "uv",
      "args": ["--directory", "~/typesense-mcp-server", "run", "mcp", "run", "main.py"],
      "env": {
        "TYPESENSE_HOST": "",
        "TYPESENSE_PORT": "", 
        "TYPESENSE_PROTOCOL": "",
        "TYPESENSE_API_KEY": ""
      }
    }
  }
}

Related MCP server: Better Qdrant MCP Server

Транспорты

Сервер поддерживает два транспорта MCP. STDIO является стандартным и используется большинством настольных клиентов (Claude Desktop, Cursor и т. д.). Для удаленных клиентов, веб-интерфейсов или инструментов без сохранения состояния, таких как чат llama.cpp, вы можете запустить его как HTTP SSE-слушатель.

STDIO (по умолчанию)

TYPESENSE_API_KEY=xyz uv run python main.py

HTTP / SSE

Установите MCP_TRANSPORT=sse (или передайте --sse) и при необходимости переопределите хост/порт:

TYPESENSE_API_KEY=xyz \
MCP_TRANSPORT=sse \
MCP_HOST=0.0.0.0 \
MCP_PORT=8000 \
uv run python main.py

Затем сервер предоставляет:

• GET http://<host>:<port>/sse — поток событий SSE (сюда подключаются клиенты)

• POST http://<host>:<port>/messages/ — конечная точка сообщений JSON-RPC

Доступные инструменты

Typesense MCP Server предоставляет следующие инструменты:

Управление сервером

• check_typesense_health - Проверяет состояние работоспособности настроенного сервера Typesense

• list_collections - Получает список всех коллекций на сервере Typesense

Управление коллекциями

• describe_collection - Получает схему и метаданные для конкретной коллекции

• export_collection - Экспортирует все документы из конкретной коллекции

• create_collection - Создает новую коллекцию с предоставленной схемой

• delete_collection - Удаляет конкретную коллекцию

• truncate_collection - Очищает коллекцию, удаляя все документы, но сохраняя схему

Операции с документами

• create_document - Создает один новый документ в конкретной коллекции

• upsert_document - Выполняет upsert (создание или обновление) одного документа в конкретной коллекции

• index_multiple_documents - Индексирует (создает, выполняет upsert или обновляет) несколько документов пакетом

• delete_document - Удаляет один документ по его ID из конкретной коллекции

• import_documents_from_csv - Импортирует документы из данных CSV в коллекцию

Возможности поиска

• search - Выполняет поиск по ключевым словам в конкретной коллекции

• vector_search - Выполняет поиск по векторному сходству в конкретной коллекции