web-search-mcp

An online search MCP server based on the DeepSeek web version. It provides real-time web search capabilities to MCP clients through DeepSeek's search-enhanced dialogue feature.

Features

• Provides the web_search MCP tool, supporting real-time web search

• Supports DeepSeek default and expert models

• Supports thinking process output

• Zero dependencies, pure Node.js implementation

• stdio transport, compatible with all MCP clients

Related MCP server: google-search-mcp

Quick Start

1. Use in Claude Desktop

Edit the Claude Desktop configuration file (claude_desktop_config.json) and pass credentials directly via the env field, no .env file required:

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

2. Use in Claude Code

Add the following to your project's .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. Use a .env file (Optional)

If it is inconvenient to write env in the MCP configuration, you can also use a .env file:

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

Environment variable priority: System environment variables > MCP env configuration > .env file

MCP Tools

web_search

Uses DeepSeek's search-enhanced dialogue to perform a web search and returns an answer based on the search results.

Parameters:

Environment Variables

Obtaining DeepSeek Credentials

1. Open chat.deepseek.com and log in

2. Open browser developer tools (F12) → switch to the Console panel

3. Enter the following command and press Enter to copy the token:

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

4. Paste it into the DEEPSEEK_AUTH_TOKEN environment variable

Note: Credentials will expire and need to be re-obtained. A typical sign of token expiration is the request returning a Cloudflare verification page.

Testing

# 运行所有测试
npm test

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

Project Structure

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           # 环境变量配置解析