Typesense MCP Server

这是一个与 Typesense 接口的 Model Context Protocol (MCP) 服务器。

安装

通过 Smithery 安装

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

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": ""
      }
    }
  }
}

可用工具

Typesense MCP 服务器提供以下工具：

服务器管理

• check_typesense_health - 检查配置的 Typesense 服务器的健康状态
• list_collections - 获取 Typesense 服务器中所有集合的列表

集合管理

• describe_collection - 获取特定集合的模式和元数据
• export_collection - 导出特定集合中的所有文档
• create_collection - 使用提供的模式创建新的集合
• delete_collection - 删除特定集合
• truncate_collection - 截断集合（删除所有文档但保留模式）

文档操作

• create_document - 在特定集合中创建一个新的文档
• upsert_document - 在特定集合中插入或更新一个文档
• index_multiple_documents - 批量索引（创建、插入或更新）多个文档
• delete_document - 根据其 ID 从特定集合中删除一个文档
• import_documents_from_csv - 将 CSV 数据导入到集合中

搜索能力

• search - 对特定集合执行关键词搜索
• vector_search - 对特定集合执行向量相似性搜索