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（1 ページ）、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 アプリの Account → API keys から作成してください。

Claude Code

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

Claude Desktop

Settings → Developer → Edit config で、次の設定を追加します。

{
  "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

その後、上記いずれかの設定でコマンドとして npx -y @zearchcomputer/mcp の代わりに node /absolute/path/to/zearch-mcp/dist/index.js を使用します。

リモート（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 です。http:// は localhost でのみ使用できます。
ZEARCH_TIMEOUT_MS	120000	リクエストごとのタイムアウトです。リサーチのストリームには、少なくとも 180 s が確保されます。
ZEARCH_REVERSE_WAIT_MS	300000	research が reverse の実行を待ってから、get_run 用の ID を返すまでの時間です。
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 security advisories を通じて非公開で報告してください。セキュリティポリシーをご覧ください。

ライセンス

MIT