Menghubungkan AI client ke Zearch untuk melakukan riset dengan jawaban yang diverifikasi terhadap sumber kutipan dan kutipan teks yang tepat.
Juga dikenal sebagai zearchcomputer/zearch-mcp, zearch-mcp, @zearchcomputer/mcp
- Stars
- 0
- Tools
- 6
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.1.0
- Commit terakhir
- 3 Nov 2026
- Lisensi
- MIT
Apa itu Zearch MCP?
Menghubungkan AI client ke Zearch untuk melakukan riset dengan jawaban yang diverifikasi terhadap sumber kutipan dan kutipan teks yang tepat. Server ini menyediakan 6 tool, seperti research, verify, get_run.
Ringkasan dibuat dari README proyek
Tentang Zearch MCP server
Zearch memungkinkan Anda melakukan riset dengan sitasi terverifikasi langsung di dalam lingkungan pengembangan AI Anda. Tool ini menghubungkan client Model Context Protocol seperti Claude, Cursor, dan VS Code ke engine Zearch untuk memberikan jawaban di mana setiap paragraf diperiksa terhadap kutipan sumber tertentu. Hal ini memastikan bahwa informasi yang diberikan berbasis pada bukti, bukan halusinasi model.
Developer dapat menggunakan tool riset ini untuk melakukan pencarian standar, laporan mendalam dari hingga delapan sumber, atau crawling situs. Server ini juga menyertakan tool verify untuk memeriksa teks Anda sendiri terhadap sumber yang disediakan, memberikan skor pass atau fail serta atribusi. Pengguna juga dapat melakukan reverse research untuk memahami cara kerja suatu aplikasi atau repository melalui static analysis.
Setup memerlukan Zearch API key dan dapat dijalankan secara lokal via npx atau dalam mode HTTP remote. Server ini mendukung berbagai mode seperti scrape, compare, dan deep research, dengan biaya yang dikelola melalui sistem kredit. Untuk client yang mendukung MCP Apps, server akan merender kartu interaktif yang berisi chip sitasi dan kutipan sumber.
Apa yang bisa Anda lakukan dengannya
- 1Menyusun laporan riset mendalamMinta AI untuk membuat laporan mendetail berdasarkan berbagai sumber web dengan sitasi yang terverifikasi.
- 2Memverifikasi akurasi konten tulisanPeriksa draf yang telah Anda tulis terhadap sekumpulan sumber untuk memastikan setiap klaim didukung oleh data.
- 3Menganalisis arsitektur perangkat lunakGunakan static analysis untuk memahami cara kerja internal dari repository atau aplikasi tertentu.
- 4Scrape halaman web spesifikEkstrak dan rangkum informasi dari satu halaman web secara langsung di dalam antarmuka chat Anda.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Zearch MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Zearch MCP di Claude Code
$ claude mcp add --env 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' zearch-mcp -- npx -y @zearchcomputer/mcpInstal Zearch MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"zearch-mcp": {
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}Instal Zearch MCP di VS Code
.vscode/mcp.json
{
"servers": {
"zearch-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}Instal Zearch MCP di VS Code CLI
$ code --add-mcp '{"name":"zearch-mcp","type":"stdio","command":"npx","args":["-y","@zearchcomputer/mcp"],"env":{"ZEARCH_API_KEY":"<YOUR_ZEARCH_API_KEY>"}}'Instal Zearch MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"zearch-mcp": {
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}Instal Zearch MCP di Codex
$ codex mcp add zearch-mcp --env 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' -- npx -y @zearchcomputer/mcpInstal Zearch MCP di Codex config.toml
~/.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>"
Instal Zearch MCP di Gemini CLI
$ gemini mcp add -s user -e 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' zearch-mcp npx -- -y @zearchcomputer/mcpInstal Zearch MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"zearch-mcp": {
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}Tool Zearch MCP 6
Terdeteksi dari READMEresearchverifyget_runlist_runsget_walletget_pricing
| research | — | |
| verify | — | |
| get_run | — | |
| list_runs | — | |
| get_wallet | — | |
| get_pricing | — |
Konfigurasi
ZEARCH_API_KEYWajibRahasiaZearch API key (zk_live_…), from Account → API keys
ZEARCH_API_URLAPI base URL; defaults to https://zearch.computer/v1
| Nama | Deskripsi | Tipe |
|---|---|---|
| ZEARCH_API_KEY | Zearch API key (zk_live_…), from Account → API keys | WajibRahasia |
| ZEARCH_API_URL | API base URL; defaults to https://zearch.computer/v1 |
Pengecekan otomatis
Berjalan 13 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauzearchcomputer/zearch-mcp is public and reachablegithub.com/zearchcomputer/zearch-mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@zearchcomputer/mcp names zearchcomputer/zearch-mcp as sourcenpmjs.com/package/@zearchcomputer/mcp ↗Lolos
- Provenance build (atestasi Sigstore)Sigstore attestation for @zearchcomputer/mcpnpmjs.com/package/@zearchcomputer/mcp/v/0.1.0#provenance ↗Lolos
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-03github.com/zearchcomputer/zearch-mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @zearchcomputer/mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya4 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di 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
Pertanyaan tentang Zearch MCP
Bagaimana cara menambahkan Zearch MCP ke Claude Code?
Jalankan claude mcp add --env 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' zearch-mcp -- npx -y @zearchcomputer/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Zearch MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan Zearch MCP?
Server ini menyediakan 6 tool, termasuk research, verify, get_run, list_runs, get_wallet.
Bagaimana Zearch memastikan jawaban yang diberikan akurat?
Setiap paragraf dalam jawaban diperiksa terhadap sumber yang dikutip, dan jika sebuah paragraf tidak dapat didukung, paragraf tersebut akan dipotong atau diganti dengan kutipan dari sumber tersebut.
Apakah server mengenakan biaya untuk kesalahan?
Tidak, kesalahan tidak pernah dikenakan biaya, dan proses yang hanya dapat mengembalikan kutipan sumber akan dikenakan biaya setengah harga.