AI 클라이언트를 Zearch에 연결하여 인용된 출처 및 정확한 구절을 바탕으로 검증된 답변을 제공하는 리서치 기능을 수행합니다.
다른 이름 zearchcomputer/zearch-mcp, zearch-mcp, @zearchcomputer/mcp
- 스타
- 0
- Tools
- 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Zearch MCP는 어떤 도구를 제공하나요?
6개 도구를 제공합니다. 예: research, verify, get_run, list_runs, get_wallet.
Zearch는 답변의 정확성을 어떻게 보장하나요?
답변의 모든 문단은 인용된 출처와 대조하여 확인하며, 근거를 뒷받침할 수 없는 문단은 삭제하거나 해당 출처의 구절로 대체합니다.
오류가 발생하면 비용이 청구되나요?
아니요, 오류에 대해서는 비용이 청구되지 않으며, 출처 구절만 반환할 수 있는 실행은 비용이 절반만 발생합니다.