AI istemcilerini Zearch'e bağlayarak, yanıtların alıntılanan kaynaklar ve tam pasajlar ile doğrulandığı araştırmalar yapmanızı sağlar.
Ayrıca bilinen adı zearchcomputer/zearch-mcp, zearch-mcp, @zearchcomputer/mcp
- Yıldızlar
- 0
- Araçlar
- 6
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.0
- Son commit
- 3 Kas 2026
- Lisans
- MIT
Zearch MCP nedir?
AI istemcilerini Zearch'e bağlayarak, yanıtların alıntılanan kaynaklar ve tam pasajlar ile doğrulandığı araştırmalar yapmanızı sağlar. 6 araç sunar; örneğin research, verify, get_run.
Özet, projenin README dosyasından oluşturuldu
Zearch MCP sunucusu hakkında
Zearch, doğrudan yapay zeka geliştirme ortamınız içerisinde doğrulanmış atıflarla araştırma yapmanıza olanak tanır. Claude, Cursor ve VS Code gibi Model Context Protocol istemcilerini Zearch motoruna bağlayarak, her paragrafın belirli kaynak pasajlarla kontrol edildiği yanıtlar sunar. Bu sayede sağlanan bilgilerin model halüsinasyonları yerine kanıtlara dayalı olması sağlanır.
Geliştiriciler bu araştırma aracını standart aramalar, sekiz kaynağa kadar derinlemesine raporlar oluşturmak veya site tarama işlemleri için kullanırlar. Sunucu ayrıca, kendi metninizi sağlanan kaynaklarla karşılaştırmak için geçme veya kalma puanları ve atıflar sunan bir doğrulama (verify) aracı da içerir. Kullanıcılar ayrıca, statik analiz yoluyla bir uygulamanın veya deponun nasıl çalıştığını anlamak için tersine araştırma (reverse research) yapabilirler.
Kurulum için bir Zearch API anahtarı gereklidir ve npx aracılığıyla yerel olarak veya uzak bir HTTP modunda çalıştırılabilir. Sunucu; scrape, compare ve deep research gibi farklı modları destekler ve maliyetler bir kredi sistemi üzerinden yönetilir. MCP Apps destekleyen istemciler için sunucu, atıf çipleri ve kaynak alıntıları içeren etkileşimli kartlar oluşturur.
Neler yapabilirsiniz
- 1Derinlemesine araştırma raporları hazırlayınYapay zekadan, doğrulanmış atıflar içeren birden fazla web kaynağına dayalı ayrıntılı bir rapor oluşturmasını isteyin.
- 2Yazılı içerik doğruluğunu teyit edinYazdığınız bir taslağı, her iddianın desteklendiğinden emin olmak için bir dizi kaynakla karşılaştırın.
- 3Yazılım mimarisini analiz edinBelirli bir deponun veya uygulamanın iç işleyişini anlamak için statik analiz kullanın.
- 4Belirli web sayfalarını tarayınTek bir web sayfasından bilgileri doğrudan sohbet arayüzünüz içinde çıkarın ve özetleyin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Zearch MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleZearch MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' zearch-mcp -- npx -y @zearchcomputer/mcpZearch MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"zearch-mcp": {
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}Zearch MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"zearch-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}Zearch MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"zearch-mcp","type":"stdio","command":"npx","args":["-y","@zearchcomputer/mcp"],"env":{"ZEARCH_API_KEY":"<YOUR_ZEARCH_API_KEY>"}}'Zearch MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"zearch-mcp": {
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}Zearch MCP'yi Codex içine yükleyin
$ codex mcp add zearch-mcp --env 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' -- npx -y @zearchcomputer/mcpZearch MCP'yi Codex config.toml içine yükleyin
~/.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>"
Zearch MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' zearch-mcp npx -- -y @zearchcomputer/mcpZearch MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"zearch-mcp": {
"command": "npx",
"args": [
"-y",
"@zearchcomputer/mcp"
],
"env": {
"ZEARCH_API_KEY": "<YOUR_ZEARCH_API_KEY>"
}
}
}
}Zearch MCP araçları 6
README dosyasından algılandıresearchverifyget_runlist_runsget_walletget_pricing
| research | — | |
| verify | — | |
| get_run | — | |
| list_runs | — | |
| get_wallet | — | |
| get_pricing | — |
Yapılandırma
ZEARCH_API_KEYGerekliGizliZearch API key (zk_live_…), from Account → API keys
ZEARCH_API_URLAPI base URL; defaults to https://zearch.computer/v1
| Ad | Açıklama | Sunucu |
|---|---|---|
| ZEARCH_API_KEY | Zearch API key (zk_live_…), from Account → API keys | GerekliGizli |
| ZEARCH_API_URL | API base URL; defaults to https://zearch.computer/v1 |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirzearchcomputer/zearch-mcp is public and reachablegithub.com/zearchcomputer/zearch-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@zearchcomputer/mcp names zearchcomputer/zearch-mcp as sourcenpmjs.com/package/@zearchcomputer/mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for @zearchcomputer/mcpnpmjs.com/package/@zearchcomputer/mcp/v/0.1.0#provenance ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-03github.com/zearchcomputer/zearch-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @zearchcomputer/mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok4 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
@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 soruları
Zearch MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'ZEARCH_API_KEY=<YOUR_ZEARCH_API_KEY>' zearch-mcp -- npx -y @zearchcomputer/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Zearch MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Zearch MCP hangi araçları sunar?
6 araç sunar; bunlar arasında research, verify, get_run, list_runs, get_wallet yer alır.
Zearch yanıtların doğruluğunu nasıl sağlar?
Bir yanıttaki her paragraf, atıfta bulunulan kaynakla karşılaştırılarak kontrol edilir; eğer bir paragraf desteklenemiyorsa, o kısım kesilir veya kaynak pasaj ile değiştirilir.
Sunucu hatalar için ücret alıyor mu?
Hayır, hatalar için asla ücret alınmaz ve yalnızca bir kaynak pasaj döndürebilen çalıştırmalar yarı fiyatına mal olur.