web-search-mcp

DeepSeek 웹 버전 기반의 온라인 검색 MCP 서버입니다. DeepSeek의 검색 강화 대화 기능을 통해 MCP 클라이언트에 실시간 웹 검색 기능을 제공합니다.

기능

실시간 웹 검색을 지원하는 web_search MCP 도구 제공
DeepSeek 기본 모델 및 전문가 모델 지원
사고 과정(thinking) 출력 지원
제로 의존성, 순수 Node.js 구현
stdio 전송, 모든 MCP 클라이언트와 호환

빠른 시작

1. Claude Desktop에서 사용하기

Claude Desktop 설정 파일(claude_desktop_config.json)을 편집하여 env 필드를 통해 자격 증명을 직접 전달합니다. .env 파일은 필요하지 않습니다:

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["D:/ai-projects/web-search-mcp/src/index.js"],
      "env": {
        "DEEPSEEK_AUTH_TOKEN": "your_token_here"
      }
    }
  }
}

2. Claude Code에서 사용하기

프로젝트의 .claude/settings.json에 다음을 추가합니다:

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["D:/ai-projects/web-search-mcp/src/index.js"],
      "env": {
        "DEEPSEEK_AUTH_TOKEN": "your_token_here"
      }
    }
  }
}

3. .env 파일 사용 (선택 사항)

MCP 설정에 env를 작성하기 불편한 경우 .env 파일을 사용할 수 있습니다:

cp .env.example .env
# 编辑 .env 填入凭据

환경 변수 우선순위: 시스템 환경 변수 > MCP env 설정 > .env 파일

MCP 도구

`web_search`

DeepSeek 검색 강화 대화를 사용하여 웹 검색을 수행하고, 검색 결과에 기반한 답변을 반환합니다.

매개변수:

매개변수	타입	필수	설명
`query`	string	예	검색 쿼리 내용
`thinking`	boolean	아니오	DeepSeek 사고/추론 모드 활성화 여부. 활성화 시 모델이 먼저 추론한 후 답변하며, 추론 과정이 응답에 포함됨 (기본값 false)
`model`	string	아니오	모델 모드: `default` 또는 `expert` (기본값은 설정값 사용)

환경 변수

변수	필수	기본값	설명
`DEEPSEEK_AUTH_TOKEN`	택일	-	DeepSeek 로그인 토큰
`DEEPSEEK_COOKIE`	택일	-	DeepSeek 브라우저 쿠키
`DEEPSEEK_MODEL_TYPE`	아니오	`default`	모델 타입: `default` 또는 `expert`
`DEEPSEEK_THINKING_ENABLED`	아니오	`false`	사고 과정 기본 활성화 여부
`WASM_PATH`	아니오	`assets/sha3_wasm_bg...wasm`	PoW 솔버 WASM 파일 경로
`LOG_LEVEL`	아니오	`info`	로그 레벨: `debug`, `info`, `error`

DeepSeek 자격 증명 획득 방법

chat.deepseek.com에 접속하여 로그인합니다.
브라우저 개발자 도구(F12)를 열고 Console(콘솔) 패널로 전환합니다.
다음 명령어를 입력하고 엔터를 누르면 토큰이 복사됩니다:

copy(JSON.parse(localStorage.getItem("userToken")).value)

복사된 값을 DEEPSEEK_AUTH_TOKEN 환경 변수에 붙여넣습니다.

주의: 자격 증명은 만료되므로 만료 시 다시 획득해야 합니다. 토큰 만료 시 요청이 Cloudflare 인증 페이지를 반환하는 현상이 발생합니다.

테스트

# 运行所有测试
npm test

# 运行单个测试文件
node --test tests/mcp-protocol.test.js
node --test tests/config.test.js

프로젝트 구조

src/
  index.js            # 入口，初始化所有组件并启动 MCP 服务器
  mcp-server.js       # MCP 协议处理（stdio 传输、JSON-RPC 分发）
  deepseek-client.js  # DeepSeek 网页版 API 客户端（会话管理、PoW、SSE 流式解析）
  pow-solver.js       # SHA3 PoW WASM 求解器
  env.js              # .env 文件加载器
  config.js           # 环境变量配置解析

web-search-mcp

web-search-mcp

기능

빠른 시작

1. Claude Desktop에서 사용하기

2. Claude Code에서 사용하기

3. .env 파일 사용 (선택 사항)

MCP 도구

`web_search`

환경 변수

DeepSeek 자격 증명 획득 방법

테스트

프로젝트 구조

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API