@tengence/search-mcp
v0.1.5
Published
Tengence Search MCP server: initialize search apps, push data and search via official APIs (thin wrapper, lazy auto-registration). 通智搜索 MCP 服务器：初始化 + 推送 + 搜索（薄封装，启动自动注册）
Maintainers
tengenceReadme
@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