MCP WebSearch

Claude Code용 MCP 서버: Perplexity Sonar를 통한 웹 검색 및 이미지 생성 — 모두 OpenRouter 키 하나로.

한 가지 목표로 작성됨: 에이전트가 실수로 비용을 낭비하지 않도록. 비싼 검색 모델은 기본값이 아니며, 이미지 생성에는 호출 전에 비용을 계산하는 별도의 도구가 있습니다.

설치

git clone git@github.com:DrSeedon/mcp-websearch.git ~/.claude/mcp-servers/websearch
cd ~/.claude/mcp-servers/websearch
npm install
cp .env.example .env   # и вписать свой ключ

Claude Code에 등록:

claude mcp add websearch node ~/.claude/mcp-servers/websearch/index.js \
  -e OPENROUTER_API_KEY=sk-or-v1-...

Node 18+ 필요 (네이티브 fetch 및 ESM 사용).

Related MCP server: sysauto Ask MCP Server

환경 변수

키는 환경에서만 읽습니다 — 코드에는 없고 있어서도 안 됩니다.

도구

search

Perplexity Sonar를 통한 웹 검색. 응답, 출처 및 비용을 반환합니다.

다른 검색 모델은 없습니다 — 목록은 코드 수준에서 고정되어 있습니다.

중요한 이유: 비용 차이는 5배입니다. 비싼 모델을 기본값으로 만들면 에이전트는 생각 없이 호출하게 됩니다. 실제 설치 환경에서 검증됨: 425건의 요청 중 171건이 모델을 명시적으로 지정하지 않아 비싼 요금제로 처리되었습니다.

generate_image

이미지 생성. 입력으로 참조 이미지를 지원하며, 화면 비율은 21:9에서 9:16까지 지원합니다.

generate_image_cost

호출 전에 생성 비용을 계산합니다. 모델 선택을 신중하게 하기 위해 필요합니다. "목록에서 첫 번째를 선택"하는 것이 아니라.

로그

requests.log (.gitignore에 있음) — JSONL, 호출당 한 줄: [iso] tool: {json}.

• search — 요청, 전체 응답, 출처, 모델, 토큰, 비용

• generate_image — 프롬프트, 저장 경로, 크기, 참조; base64는 로그에 기록되지 않음

• generated/의 이미지 옆에는 동일한 프롬프트와 메타데이터가 담긴 .json 파일이 생성됨

커밋하지 않는 것

.env, requests.log, generated/ (생성된 이미지 아카이브), node_modules/. 로그와 이미지에는 요청 기록이 포함되어 있습니다 — 이는 개인 데이터이므로 저장소에 있으면 안 됩니다.