web-search-mcp

Servidor MCP de búsqueda en línea basado en la versión web de DeepSeek. Proporciona capacidades de búsqueda web en tiempo real a clientes MCP a través de la función de diálogo mejorado con búsqueda de DeepSeek.

Funcionalidades

• Proporciona la herramienta MCP web_search, que admite búsqueda web en tiempo real

• Admite modelos predeterminados y modelos expertos de DeepSeek

• Admite la salida del proceso de pensamiento (thinking)

• Cero dependencias, implementación pura en Node.js

• Transporte stdio, compatible con todos los clientes MCP

Inicio rápido

1. Uso en Claude Desktop

Edite el archivo de configuración de Claude Desktop (claude_desktop_config.json) y pase las credenciales directamente a través del campo env, sin necesidad de un archivo .env:

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

2. Uso en Claude Code

Agregue lo siguiente en el archivo .claude/settings.json del proyecto:

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

3. Uso de un archivo .env (opcional)

Si no es conveniente escribir env en la configuración de MCP, también puede usar un archivo .env:

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

Prioridad de las variables de entorno: Variables de entorno del sistema > Configuración env de MCP > Archivo .env

Herramientas MCP

web_search

Utiliza el diálogo mejorado con búsqueda de DeepSeek para realizar búsquedas web y devuelve respuestas basadas en los resultados de la búsqueda.

Parámetros:

Variables de entorno

Obtención de credenciales de DeepSeek

1. Abra chat.deepseek.com e inicie sesión

2. Abra las herramientas de desarrollo del navegador (F12) → cambie al panel Console (Consola)

3. Ingrese el siguiente comando y presione Enter para copiar el token:

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

4. Péguelo en la variable de entorno DEEPSEEK_AUTH_TOKEN

Nota: Las credenciales caducan y deben obtenerse de nuevo cuando expiren. Una señal típica de que el token ha caducado es que la solicitud devuelva una página de verificación de Cloudflare.

Pruebas

# 运行所有测试
npm test

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

Estructura del proyecto

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