T

Typesense搜索服务器

@avarant/typesense-mcp-server
0 Stars 95 次浏览 avarant 更新于 2026-08-23

通过模型上下文协议在 Typesense 数据库中启用向量和关键词搜索功能的服务器,提供集合管理、文档操作和搜索功能的工具。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量:TYPESENSE_API_KEY、TYPESENSE_HOST、TYPESENSE_PORT、TYPESENSE_PROTOCOL

服务介绍

Typesense MCP 服务器

一个与 Typesense 接口的 模型上下文协议 (MCP) 服务器

安装

安装 uv

在 Mac 上,你可以使用 homebrew 来安装它

brew install uv

克隆包

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

更新你的 .cursor/mcp.json 以在 Cursor 中使用

{
  "mcpServers": {
    "server-name": {
      "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 - 对特定集合执行向量相似性搜索

相关 MCP 服务