Zearch

在任何 MCP 客户端中，获取可核验的答案。

@zearchcomputer/mcp 可将 Claude、Cursor、VS Code 等 Model Context Protocol 客户端连接到 Zearch。提出问题，即可获得答案：每个段落都经过其引用来源的核验，并附上 Zearch 读取的原文片段。也可以对照已有来源，核验你自己的模型撰写的文本。

状态： 目前仍处于早期阶段。Zearch API 尚未向所有人开放。

答案如何生成

flowchart LR
  Q([Question]) --> S[Search]
  S --> J1[Jev selects<br/>passages]
  J1 --> W[Writer drafts from<br/>those passages only]
  W --> J2[Jev checks<br/>each paragraph]
  J2 -->|supported| A([Cited answer])
  J2 -->|not supported| E([The source<br/>passage itself])

Jev 是 TypeSafe AI 的证据模型。无法获得支持的段落会被删除；如果最终没有剩下任何内容，你会得到最佳来源片段，而不是猜测（answer_type: "excerpt"）。

工具

工具	功能	积分
research	提供带编号来源的核验答案，以及 Jev 读取的原文片段。模式：standard、deep（基于最多 8 个来源生成报告）、compare、scrape（单个页面）、crawl（抓取某个站点最多 5 个页面）、reverse（通过静态分析了解应用、代码仓库或网站的工作方式）。使用 parent_id 进行后续提问。	1 · 5 · 2 · 1 · 3 · 10；后续提问 0.3
verify	逐段对照来源核验你的文本：通过/未通过、支持度和归属度评分。来源引用格式为 [1]、[2]……	1
get_run	重新打开某次运行，或查看已排队的 reverse 运行状态。	免费
list_runs	查看最近的运行记录（与 Zearch 应用共享）。	免费
get_wallet	查看积分余额、积分批次及到期时间，以及最近的账本条目。	免费
get_pricing	查看公开价格表。无需密钥。	免费

错误不会扣费。只能返回来源片段的运行，费用减半。

进度。 research 会通过 MCP 进度通知流式传输各个阶段（搜索网络 → 选择最相关的证据 → 根据来源核验每项声明），因此支持显示进度的客户端可以展示 Zearch 正在进行的操作。

答案视图。 在支持 MCP Apps 的客户端中，research、get_run 和 verify 会以内嵌卡片形式呈现：包含引用标签的答案、带有 Jev 读取片段的来源卡片、每个来源对应的 打开 按钮，以及后续提问建议。界面会适配客户端的浅色或深色主题。其他客户端会以文本形式显示相同内容。设置 ZEARCH_UI=0 可关闭此功能。

资源。 zearch://runs/{id}（以 Markdown 格式查看某次运行；其中会列出最近的运行记录）、zearch://pricing。

提示词。 research_brief（基于深度研究生成带引用的简报）、fact_check（为草稿查找来源，然后进行核验）、compare（每个单元格都带有引用的表格）。

安装

你需要一个 Zearch API 密钥（zk_live_…）。在 Zearch 应用的 账户 → API 密钥 中创建密钥。

Claude Code

claude mcp add zearch --env ZEARCH_API_KEY=zk_live_your_key -- npx -y @zearchcomputer/mcp

Claude Desktop

在 设置 → 开发者 → 编辑配置 中添加：

{
  "mcpServers": {
    "zearch": {
      "command": "npx",
      "args": ["-y", "@zearchcomputer/mcp"],
      "env": { "ZEARCH_API_KEY": "zk_live_your_key" }
    }
  }
}

Cursor

.cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：使用与 Claude Desktop 相同的 mcpServers 配置块。

VS Code

.vscode/mcp.json，此配置会提示输入密钥，而不是将密钥存储在文件中：

{
  "inputs": [{ "type": "promptString", "id": "zearch-key", "description": "Zearch API key", "password": true }],
  "servers": {
    "zearch": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@zearchcomputer/mcp"],
      "env": { "ZEARCH_API_KEY": "${input:zearch-key}" }
    }
  }
}

从源代码运行

git clone https://github.com/zearchcomputer/zearch-mcp
cd zearch-mcp
npm ci && npm run build

然后，在上述任一配置中，将命令设置为 node /absolute/path/to/zearch-mcp/dist/index.js，以替代 npx -y @zearchcomputer/mcp。

远程（HTTP）模式

npx -y @zearchcomputer/mcp --http --port 8787            # http://127.0.0.1:8787/mcp

每个请求都使用调用方自己的密钥，并以 Authorization: Bearer zk_live_… 的形式发送；服务端不存储任何密钥。只有当服务在环回地址上监听时，才会将 ZEARCH_API_KEY 用作备用密钥，因此公开部署不会替他人消耗运营方的额度。GET /healthz 会报告服务是否正常运行。

要在公共接口上提供服务，请绑定该接口并列出你提供服务的主机名，这样就会拒绝带有其他 Host 标头的请求：

npx -y @zearchcomputer/mcp --http --host 0.0.0.0 --port 8080 --allowed-hosts mcp.zearch.computer

其中包含一个 Dockerfile。

配置

变量	默认值	用途
ZEARCH_API_KEY		你的 API 密钥。在 HTTP 模式下，调用方会发送自己的密钥。
ZEARCH_API_URL	https://zearch.computer/v1	API 基础 URL。仅对 localhost 接受 http://。
ZEARCH_TIMEOUT_MS	120000	每个请求的超时时间。研究流的超时时间至少为 180 s。
ZEARCH_REVERSE_WAIT_MS	300000	research 等待 reverse 运行的时长；超时后会返回其 ID，供 get_run 使用。
ZEARCH_UI	on	设为 0 可关闭内嵌回答视图。
ZEARCH_MCP_ALLOWED_HOSTS		与 --allowed-hosts 相同。
PORT	8787	未指定 --port 时使用的 HTTP 端口。

可靠性

• 每次 research 调用都会携带幂等键，并在重试时复用，因此重试请求不会重复运行或重复扣费。
• 网络故障、5xx 响应和每分钟速率限制都会在退避后重试，并遵循 Retry-After。额度不足、身份验证和验证错误不会重试；它们会作为工具错误返回，并说明后续操作。
• 如果研究流中断，服务端会读取已完成的运行结果，而不是直接失败。
• 在客户端取消工具调用时，也会取消发送到 Zearch 的请求。
• 日志会写入 stderr。密钥绝不会记录到日志中。

开发

npm ci
npm test        # builds, then runs the tests against a local mock of the Zearch API

测试不会发起 localhost 以外的网络调用，也不会消耗额度。视图是 src/ui/answer.html 中的单个无依赖 HTML 文件。

该服务基于 MCP TypeScript SDK v2 构建（协议修订版本为 2026-07-28，同时仍支持 2025 年时期的客户端），并与 Zearch API 通信。

安全

请通过 GitHub 安全公告 私下报告漏洞。请参阅安全策略。

许可证

MIT