@tengence/search-mcp

@tengence/search-mcp

Tengence Search（通智搜索）MCP server：初始化搜索应用 → 推送数据 → 搜索。薄封装，进程启动零副作用（懒加载：首次调用工具时自动注册客户端身份，幂等、用户无感）。

安装（任意 MCP 客户端）

{
  "mcpServers": {
    "tengence-search": {
      "command": "npx",
      "args": ["-y", "@tengence/search-mcp"]
    }
  }
}

支持 npx 的客户端均可直接使用（Claude Desktop / Cursor / VS Code / 各类 AI 工作台）。远程 HTTP 模式（可选，Streamable HTTP）：

TENGENCE_MCP_TRANSPORT=http TENGENCE_MCP_PORT=8787 TENGENCE_MCP_TOKEN=sk-xxx npx -y @tengence/search-mcp

工具

工具	作用
search_init	初始化（幂等）：自动注册客户端 → 服务端创建「数据集 + 搜索应用」并绑定（免费套餐）→ 双 API Key 落盘本地（0600）。首次注册成功时返回激活链接与登录信息；未激活账号需先完成「设置密码 + 绑定手机」
data_push	推送数据（单条/批量）：每条必须含唯一 id（不存在→新增；存在→更新；仅含 id→删除）。首次推送后自动启动搜索应用
search	搜索：分页 / 排序 / 过滤 / 高亮 / 聚合 / 字段限制（与官方 API 1:1）
ping	诊断：注册/初始化状态 + 配置概览（密钥掩码）；probe=true 探测三下游

环境变量（可选）

变量	默认
TENGENCE_SOLUTION_BASE_URL	https://console.tengence.com
TENGENCE_SEARCH_API_KEY	搜索 Key（不配也行，search_init 自动获取落盘）
TENGENCE_DATASET_API_KEY	数据集 Key（同上）
TENGENCE_SITE_URL	注册幂等匹配键，默认 https://tengence-mcp.local/<deviceId>
TENGENCE_SEARCH_HOME	本地状态目录，默认 ~/.tengence/search-mcp

本地身份与凭据保存在 ~/.tengence/search-mcp/state.json（0600），跨会话复用，删除即视为新设备。

文档

• 安装与使用详解：https://www.tengence.com/blog/article/tengence-search-mcp/
• CLI 版本：@tengence/search-cli（脚本 / CI 友好）
• 能力层：@tengence/search-sdk

License

MIT