websearch-deepseek

通用 MCP Server — 基于 DeepSeek 原生联网搜索 API 的 Web Search 工具。

适用于 Claude Code、Cursor、Continue、OpenCode、pi 等任何支持 MCP 协议的 AI 编程助手。

特性

🔍 DeepSeek 原生搜索 — 使用服务端 web_search_20250305 工具，非第三方搜索 API
📝 AI 生成答案 — 返回基于完整网页内容生成的详细回答，而非仅 URL 列表
🔗 附带来源链接 — 每条回答下附原文 URL，可追溯验证
⚙️ 灵活配置 — 支持选择模型、开关思考模式、调整 token 上限
🌐 MCP 协议 — 标准 JSON-RPC over stdio，兼容所有 MCP 客户端

工作原理

用户提问 → DeepSeek 模型
                ↓
        服务端执行 web_search（抓取网页）
                ↓
        加密网页内容 → 服务端解密 → 喂给模型
                ↓
        模型基于完整内容生成详细回答
                ↓
返回：AI 生成的答案 + 来源 URL 列表

一次 MCP 工具调用 = 一次 DeepSeek API 请求，搜索、解密、回答全在服务端完成。

快速开始

1. 获取 DeepSeek API Key

前往 DeepSeek Platform 注册并获取 API Key。

2. 安装

npm install -g websearch-deepseek

3. 配置你的 AI 编程助手

在对应助手的 MCP 配置文件中添加：

Claude Code

编辑 ~/.claude/claude_desktop_config.json 或项目中的 .mcp.json：

{
  "mcpServers": {
    "websearch-deepseek": {
      "command": "npx",
      "args": ["websearch-deepseek"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "WEBSEARCH_MODEL": "deepseek-v4-flash",
        "WEBSEARCH_THINKING": "enabled"
      }
    }
  }
}

Cursor

编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "websearch-deepseek": {
      "command": "npx",
      "args": ["websearch-deepseek"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Continue (VS Code)

编辑 ~/.continue/config.json，在 mcpServers 中添加：

{
  "mcpServers": [
    {
      "name": "websearch-deepseek",
      "command": "npx",
      "args": ["websearch-deepseek"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  ]
}

pi

编辑 ~/.pi/agent/settings.json，在 mcp 中添加：

{
  "mcp": {
    "websearch-deepseek": {
      "command": "npx",
      "args": ["websearch-deepseek"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

4. 开始使用

重启你的 AI 编程助手后，直接提问即可。当需要实时信息时，助手会自动调用 web_search 工具。

例如：

"帮我查一下 React 19 有哪些新特性"
"搜索 Python 3.13 的发布时间和主要更新"
"最近的 AI 行业有什么重大新闻"

环境变量配置

变量	必填	默认值	说明
`DEEPSEEK_API_KEY`	✅ 是	-	DeepSeek API Key
`WEBSEARCH_API_KEY`	❌ 否	-	API Key 备选变量名
`WEBSEARCH_MODEL`	❌ 否	`deepseek-v4-flash`	模型：`deepseek-v4-flash`（快）或 `deepseek-v4-pro`（强）
`WEBSEARCH_THINKING`	❌ 否	`enabled`	思考模式：`enabled` / `disabled`
`WEBSEARCH_MAX_TOKENS`	❌ 否	`8192`	回复最大 token 数

模型选择建议

场景	推荐模型	说明
日常搜索（默认）	`deepseek-v4-flash`	速度快、成本低，回答质量足够好
深度研究	`deepseek-v4-pro`	更详细、更准确的回答，但稍慢

思考模式

enabled（默认）：模型会先思考再回答，答案质量更高，但消耗更多 token
disabled：跳过思考步骤，速度更快，适合简单查询

命令行使用

也可以直接在终端中使用：

# 设置 API Key
export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx

# 搜索
npx websearch-deepseek search "Node.js LTS 版本"

# JSON 输出
npx websearch-deepseek search --json "TypeScript 5.8"

# 指定模型和关闭思考
npx websearch-deepseek search --model deepseek-v4-pro --no-thinking "Rust 最新版本"

输出示例

## Node.js 最新 LTS 版本

截至目前（2025 年 7 月），Node.js 最新的 Active LTS 版本是 Node.js 24.x...

| 版本 | 状态 | 首发日期 | 支持至 |
|------|------|----------|--------|
| 24.x | Active LTS | 2025-05-06 | 2028-04 |
| 22.x | Maintenance | 2024-10 | 2027-04 |

### 建议
- 新项目：推荐使用 Node.js 24 LTS
- 现有项目：Node.js 22 仍可继续使用

---

### Sources (10):
1. [Node.js 24.0 is available...](https://...)
2. [Node.js — Node.js Releases](https://...)
...

费用说明

本工具使用 DeepSeek API，按 token 计费。一次搜索大约消耗：

项目	估计 token
搜索 + 思考	~5,000-8,000
生成回答	~1,000-3,000
单次总计	约 8,000-15,000 token

DeepSeek API 价格请参考官方定价。

开发

git clone https://github.com/your-username/websearch-deepseek.git
cd websearch-deepseek
npm install

# 类型检查
npm run check

# 命令行测试
npm run search "Node.js latest LTS"

# 代码格式化
npm run format

License

MIT

websearch-deepseek