한 줄 명령으로 로컬 MCP 서버를 설치합니다.
maru-deep-pro-search
AI 코딩 에이전트에 웹 검색을 한 줄로 붙이세요
Cursor, Claude Code, Codex 같은 로컬 에이전트가 최신 문서와 웹 근거를 직접 확인하게 해줍니다. 설치는 한 줄, 첫 검색은 바로 시작합니다. 상용 검색 API 키 없이 로컬 MCP 연구 서버를 붙입니다.
curl -LsSf https://raw.githubusercontent.com/claudianus/maru-deep-pro-search/main/scripts/install.sh | sh
로컬 실행
상용 검색 API 키 없음
빠른 첫 검색
Cursor, Claude Code, Codex를 재시작해 MCP 서버를 로드합니다.
신뢰할 수 있는 출처를 바탕으로 답을 얻으세요.
Setup
처음엔 세 단계면 충분합니다
`scripts/install.sh` 한 줄로 설치하고, 에이전트를 완전히 재시작한 다음 `search("...")`를 요청하세요. `setup --check --json`은 무언가 이상할 때 쓰는 읽기 전용 diagnostics입니다.
Doctor JSON
필요할 때만 `maru-deep-pro-search-setup setup --check --json`으로 MCP 등록, 브라우저 지원, evidence 경로, repair hint를 확인합니다.
First search
첫 검색은 “공식 문서 찾아줘”로 시작하세요
예: `React 19 useActionState 공식 문서 찾아줘`. Maru는 search, fetch, verify, get_evidence 순서로 근거를 보여주고, 에이전트가 답변을 쓰기 전에 확인할 재료를 남깁니다.
$ 첫 검색 / first search
search("React 19 useActionState 공식 문서 찾아줘")ok search: official React docs candidates
fetch: react.dev/reference/react/useActionState
verify: support=2 conflict=0 needs_review=0
get_evidence: metadata-only run saved
Instrumented Clarity: first search ready
Instrumented Clarity — first search source signals
| ID | Source | Kind | Coverage | Access | Noise |
|---|---|---|---|---|---|
| [1] | React Docs — useActionState | official | high | ok | low |
| [2] | React 19 release notes | official | medium | ok | low |
| [3] | React reference — form actions | official | medium | ok | low |
Before Maru
- Ask for a current API detail
- Hope the agent remembers it
- Source trail is hard to inspect
- Warnings arrive as vague prose
First search with Maru
- search finds React 19 docs
- fetch reads the official page
- verify separates support/conflict
- get_evidence keeps metadata-only trace
Operating boundary
호스트 주도 MCP 연구 서버입니다
Maru는 답변 엔진이 아닙니다. 호스트가 결정하고, Maru가 제공하는 것은 검색 후보, 본문 추출, evidence metadata, 접근 위험, 진단 신호입니다.
호스트가 결정
- 질문의 범위, 키워드, source_scope, 충분성 기준
- 어떤 URL을 읽을지, 어떤 충돌을 검증할지
- 최종 판단, 인용 배치, 사용자 답변
Maru가 제공
- 검색 후보, 랭킹 신호, 엔진 상태
- 본문 추출, 외부 콘텐츠 경계, 접근 위험 metadata
- metadata-only evidence ledger와 setup diagnostics
Public MCP surface
9개 도구는 작업 흐름으로만 기억하세요
이름은 실제 서버에 등록된 public MCP surface와 맞춥니다. 초보자는 표를 외우지 말고 “찾기, 읽기, 확인, 남기기, 점검” 흐름으로 쓰면 됩니다.
찾기와 읽기
최신 후보를 찾고 필요한 페이지만 가져옵니다.
searchfetchfetch_bulk확인과 기록
출처 간 support, contradiction, conflict를 보고 metadata-only evidence로 남깁니다.
verifyget_evidencelist_evidence_runs상태 점검
설치된 버전, 엔진 목록, 엔진 상태를 확인합니다.
versionlist_enginesengine_healthEvidence and limits
근거를 남기되 원문을 저장하지 않습니다
Maru는 더 나은 결론을 보장하지 않습니다. 대신 접근 위험, 추출 품질, 경고, citation metadata를 드러내 호스트가 더 나은 판단을 하도록 돕습니다.
metadata-only
URL, 제목, 접근 위험, 추출 품질, 경고, citation metadata를 저장합니다.
저장하지 않는 것
raw HTML, raw body, 쿠키, 토큰, 개인 브라우저 세션 값은 evidence ledger에 저장하지 않습니다.
접근 정책
robots, rate limit, 차단 페이지, site policy는 도구 출력과 access metadata에 드러냅니다.
Agent setup
로컬 에이전트 설정을 감지합니다
Maru는 에디터/에이전트별 전역 MCP 등록을 돕습니다. 정확한 감지 결과는 현재 머신에서 `setup --list`로 확인합니다.
Claude Code
User-level MCP registration and research reminders.
Cursor
MCP registration, rules, and setup diagnostics.
Codex
Local MCP config with auto-approval guidance where supported.
Cline
MCP server registration with local rule files.
Hermes
Plugin entry point and YAML-style MCP discovery.
Zed
Context server configuration for local search tools.
Resources
짧은 문서, 확인 가능한 출처
공개 문서는 실제 MCP 표면, 설치 경로, evidence contract와 같은 방향을 유지합니다.