AIクライアントをZearchに接続し、引用元と正確な一節に基づいて検証された回答によるリサーチを実行します。
別名 zearchcomputer/zearch-mcp, zearch-mcp, @zearchcomputer/mcp
- スター
- 0
- ツール
- 6
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.0
- 最終コミット
- 2026年11月3日
- ライセンス
- MIT
Zearch MCPとは
AIクライアントをZearchに接続し、引用元と正確な一節に基づいて検証された回答によるリサーチを実行します。 6個のツールを提供しており、research, verify, get_runなどがあります。
プロジェクトのREADMEから生成された概要
Zearch MCP server について
Zearchは、AI開発環境内で検証済みの引用を用いたリサーチを可能にします。Claude、Cursor、VS CodeなどのModel Context ProtocolクライアントをZearchエンジンに接続し、すべての段落が特定のソースの一節と照合された回答を提供します。これにより、提供される情報がモデルのハルシネーションではなく、エビデンスに基づいたものであることが保証されます。
開発者はこのリサーチツールを使用して、標準的な検索、最大8つのソースからの詳細なレポート作成、またはサイトのクローリングを行うことができます。また、このサーバーには、自身のテキストを提示されたソースと照合するverifyツールも含まれており、合格または不合格のスコアと属性情報を提供します。さらに、静的解析を通じてアプリケーションやリポジトリの仕組みを理解するためのリバースリサーチも実行可能です。
セットアップにはZearch APIキーが必要で、npx経由でのローカル実行、またはリモートのHTTPモードでの実行が可能です。サーバーはscrape、compare、deep researchなどの異なるモードをサポートしており、コストはクレジットシステムを通じて管理されます。MCP Appsをサポートするクライアントでは、引用チップやソースの抜粋を含むインタラクティブなカードが表示されます。
できること
- 1詳細なリサーチレポートの作成複数のウェブソースに基づき、検証済みの引用を含む詳細なレポートをAIに生成させます。
- 2作成したコンテンツの正確性の検証作成したドラフトをソースセットと照合し、すべての主張に根拠があることを確認します。
- 3ソフトウェアアーキテクチャの分析静的解析を使用して、特定のリポジトリやアプリケーションの内部構造を理解します。
- 4特定のウェブページのスクレイピングチャットインターフェース内で直接、単一のウェブページから情報を抽出して要約します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Zearch MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにZearch MCPをインストール
$ claude mcp add --env 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' zearch-mcp -- npx -y @zearchcomputer/mcpCursorにZearch MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"zearch-mcp": {
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}VS CodeにZearch MCPをインストール
.vscode/mcp.json
{
"servers": {
"zearch-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}VS Code CLIにZearch MCPをインストール
$ code --add-mcp '{"name":"zearch-mcp","type":"stdio","command":"npx","args":["-y","@zearchcomputer/mcp"],"env":{"ZEARCH_API_KEY":"<YOUR_ZEARCH_API_KEY>"}}'Claude DesktopにZearch MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"zearch-mcp": {
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}CodexにZearch MCPをインストール
$ codex mcp add zearch-mcp --env 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' -- npx -y @zearchcomputer/mcpCodex config.tomlにZearch MCPをインストール
~/.codex/config.toml
[mcp_servers.zearch-mcp] command = "npx" args = ["-y", "@zearchcomputer/mcp"] [mcp_servers.zearch-mcp.env] ZEARCH_API_KEY = "<YOUR_ZEARCH_API_KEY>"
Gemini CLIにZearch MCPをインストール
$ gemini mcp add -s user -e 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' zearch-mcp npx -- -y @zearchcomputer/mcpGemini settings.jsonにZearch MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"zearch-mcp": {
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}Zearch MCPツール 6
READMEから検出researchverifyget_runlist_runsget_walletget_pricing
| research | — | |
| verify | — | |
| get_run | — | |
| list_runs | — | |
| get_wallet | — | |
| get_pricing | — |
設定
ZEARCH_API_KEY必須シークレットZearch API key (zk_live_…), from Account → API keys
ZEARCH_API_URLAPI base URL; defaults to https://zearch.computer/v1
| 名前 | 説明 | 種類 |
|---|---|---|
| ZEARCH_API_KEY | Zearch API key (zk_live_…), from Account → API keys | 必須シークレット |
| ZEARCH_API_URL | API base URL; defaults to https://zearch.computer/v1 |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能zearchcomputer/zearch-mcp is public and reachablegithub.com/zearchcomputer/zearch-mcp ↗合格
- パッケージがこのリポジトリをソースとして指定@zearchcomputer/mcp names zearchcomputer/zearch-mcp as sourcenpmjs.com/package/@zearchcomputer/mcp ↗合格
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for @zearchcomputer/mcpnpmjs.com/package/@zearchcomputer/mcp/v/0.1.0#provenance ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-03github.com/zearchcomputer/zearch-mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @zearchcomputer/mcp合格
- パッケージおよびその依存関係に重大な勧告なし4 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない6 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見る@zearchcomputer/mcp connects Claude, Cursor, VS Code and other Model Context Protocol clients to Zearch. Ask a question and you get an answer whose every paragraph was checked against the source it cites, with the exact passage Zearch read. Or check text your own model wrote against sources you already have.
Status: early. The Zearch API is not open to everyone yet.
How an answer is made
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 is TypeSafe AI's evidence model. When a paragraph can't be supported it is cut, and when nothing survives you get the best source passage instead of a guess (answer_type: "excerpt").
Tools
| Tool | What it does | Credits |
|---|---|---|
research |
Checked answer with numbered sources and the passages Jev read. Modes: standard, deep (a report from up to 8 sources), compare, scrape (one page), crawl (up to five pages of a site), reverse (how an app, repo or site works, from static analysis). Follow-ups with parent_id. |
1 · 5 · 2 · 1 · 3 · 10; follow-up 0.3 |
verify |
Checks your text against your sources, paragraph by paragraph: pass/fail, support and attribution scores. Cite sources as [1], [2]… |
1 |
get_run |
Reopens a run, or checks on a queued reverse run. |
free |
list_runs |
Your recent runs (shared with the Zearch app). | free |
get_wallet |
Credit balance, lots and expiry, recent ledger entries. | free |
get_pricing |
Public price list. No key needed. | free |
Errors are never charged. A run that can only return a source passage costs half.
Progress. research streams its stages (Searching the web → Choosing the most relevant evidence → Checking each claim against its source) as MCP progress notifications, so clients that show progress show what Zearch is doing.
Answer view. In clients that support MCP Apps, research, get_run and verify render an inline card: the answer with citation chips, source cards with the excerpt Jev read, an Open button for each source, and follow-up suggestions. It follows the client's light or dark theme. Other clients get the same content as text. Set ZEARCH_UI=0 to turn it off.
Resources. zearch://runs/{id} (a run as Markdown; your recent runs are listed), zearch://pricing.
Prompts. research_brief (a cited brief from deep research), fact_check (find sources for a draft, then verify it), compare (a table with a citation in every cell).
Install
You need a Zearch API key (zk_live_…). Create one in the Zearch app under Account → API keys.
Claude Code
claude mcp add zearch --env ZEARCH_API_KEY=zk_live_your_key -- npx -y @zearchcomputer/mcp
Claude Desktop
In Settings → Developer → Edit config, add:
{
"mcpServers": {
"zearch": {
"command": "npx",
"args": ["-y", "@zearchcomputer/mcp"],
"env": { "ZEARCH_API_KEY": "zk_live_your_key" }
}
}
}
Cursor
.cursor/mcp.json (project) or ~/.cursor/mcp.json (global): the same mcpServers block as Claude Desktop.
VS Code
.vscode/mcp.json, which prompts for the key instead of storing it:
{
"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}" }
}
}
}
Run from source
git clone https://github.com/zearchcomputer/zearch-mcp
cd zearch-mcp
npm ci && npm run build
Then use node /absolute/path/to/zearch-mcp/dist/index.js as the command in any config above, instead of npx -y @zearchcomputer/mcp.
Remote (HTTP) mode
npx -y @zearchcomputer/mcp --http --port 8787 # http://127.0.0.1:8787/mcp
Every request uses the caller's own key, sent as Authorization: Bearer zk_live_…; the server stores no keys. ZEARCH_API_KEY is used as a fallback only when the server listens on loopback, so a public deployment can't spend the operator's credits for someone else. GET /healthz reports liveness.
To serve on a public interface, bind it and list the hostnames you serve, so requests with other Host headers are refused:
npx -y @zearchcomputer/mcp --http --host 0.0.0.0 --port 8080 --allowed-hosts mcp.zearch.computer
A Dockerfile is included for this.
Configuration
| Variable | Default | Purpose |
|---|---|---|
ZEARCH_API_KEY |
Your API key. In HTTP mode, callers send their own. | |
ZEARCH_API_URL |
https://zearch.computer/v1 |
API base URL. http:// is accepted only for localhost. |
ZEARCH_TIMEOUT_MS |
120000 |
Per-request timeout. Research streams get at least 180 s. |
ZEARCH_REVERSE_WAIT_MS |
300000 |
How long research waits for a reverse run before returning its id for get_run. |
ZEARCH_UI |
on | 0 turns off the inline answer view. |
ZEARCH_MCP_ALLOWED_HOSTS |
Same as --allowed-hosts. |
|
PORT |
8787 |
HTTP port when --port isn't given. |
Reliability
- Each
researchcall carries an idempotency key, reused across retries, so a retried request never runs or charges twice. - Network failures, 5xx responses and per-minute rate limits are retried with backoff that honours
Retry-After. Out-of-credit, auth and validation errors are not retried; they come back as a tool error that says what to do next. - If a research stream drops, the server reads the finished run instead of failing.
- Cancelling a tool call in the client cancels the request to Zearch.
- Logs go to stderr. Keys are never logged.
Development
npm ci
npm test # builds, then runs the tests against a local mock of the Zearch API
Tests make no network calls beyond localhost and spend no credits. The view is a single dependency-free HTML file in src/ui/answer.html.
The server is built on the MCP TypeScript SDK v2 (protocol revision 2026-07-28, with 2025-era clients still served) and talks to the Zearch API.
Security
Report vulnerabilities privately through GitHub security advisories. See the security policy.
License
Zearch MCPのよくある質問
Zearch MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' zearch-mcp -- npx -y @zearchcomputer/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Zearch MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Zearch MCPが提供するツールは
6個のツールを提供しており、research, verify, get_run, list_runs, get_walletなどがあります。
Zearchはどのように回答の正確性を保証しますか?
回答のすべての段落は、引用しているソースと照合されます。根拠となる段落が見つからない場合は、その部分が削除されるか、ソースの一節に置き換えられます。
エラーが発生した場合、料金は発生しますか?
いいえ、エラーに対して料金が発生することはありません。ソースの一節のみを返す実行については、半額のコストとなります。