Typesense MCP 服务器

一个与 Typesense 进行交互的 模型上下文协议 (MCP) 服务器。

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Typesense 服务器集成：

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 等）所使用的。对于远程客户端、Web UI 或像 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 服务器提供以下工具：

服务器管理

• 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 - 批量索引（创建、插入或更新）多个文档

• delete_document - 通过 ID 从特定集合中删除单个文档

• import_documents_from_csv - 将 CSV 数据中的文档导入到集合中

搜索功能

• search - 在特定集合上执行关键词搜索

• vector_search - 在特定集合上执行向量相似度搜索