# DeepSeek Search MCP

[English](README.en.md)

非官方的本地 MCP Server，使用 DeepSeek 开放平台 API Key 调用联网搜索和网页抓取接口。仅支持 stdio。

## 环境要求

- Node.js 22 或更新版本
- npm
- DeepSeek 开放平台 API Key，可在 [API Key 管理页面](https://platform.deepseek.com/api_keys)创建

## 安装与启动

推荐使用 npm 全局安装，适合日常使用，启动开销较低且无需自行构建。npx 配置方便，适合快速试用，但启动开销较高；源码构建适合需要修改代码的用户。

以下以 DeepSeek Harness (DSH) 为例，将配置合并到用户级 `~/.dsh/cordis.patch.yml`，替换 API Key 占位符。

保存配置后，若配置变更未生效，工具未出现在 MCP 列表中，可尝试重启客户端。

### npm 全局安装（推荐）

```shell
npm install -g deepseek-search-mcp@latest
```

安装完成后，使用以下启动配置：

- Windows：

  ```yaml
  - insert:
      - id: mcp-deepseek-search
        name: '@deepseek-ai/dsh-mcp-client'
        config:
          serverName: deepseek-search
          transport: stdio
          command: cmd
          args: ['/c', 'deepseek-search-mcp']
          env:
            DEEPSEEK_API_KEY: 'YOUR_DEEPSEEK_API_KEY'
            DEEPSEEK_ENABLE_WEB_FETCH: 'false'
          toolCallTimeoutMs: 80000
  ```

- macOS / Linux：

  ```yaml
  - insert:
      - id: mcp-deepseek-search
        name: '@deepseek-ai/dsh-mcp-client'
        config:
          serverName: deepseek-search
          transport: stdio
          command: deepseek-search-mcp
          args: []
          env:
            DEEPSEEK_API_KEY: 'YOUR_DEEPSEEK_API_KEY'
            DEEPSEEK_ENABLE_WEB_FETCH: 'false'
          toolCallTimeoutMs: 80000
  ```

### npx 快速试用

无需全局安装或自行编译，配置方便，但启动开销高于全局安装。

- Windows：

  ```yaml
  - insert:
      - id: mcp-deepseek-search
        name: '@deepseek-ai/dsh-mcp-client'
        config:
          serverName: deepseek-search
          transport: stdio
          command: cmd
          args: ['/c', 'npx', '-y', 'deepseek-search-mcp@latest']
          env:
            DEEPSEEK_API_KEY: 'YOUR_DEEPSEEK_API_KEY'
            DEEPSEEK_ENABLE_WEB_FETCH: 'false'
          toolCallTimeoutMs: 80000
  ```

- macOS / Linux：

  ```yaml
  - insert:
      - id: mcp-deepseek-search
        name: '@deepseek-ai/dsh-mcp-client'
        config:
          serverName: deepseek-search
          transport: stdio
          command: npx
          args: ['-y', 'deepseek-search-mcp@latest']
          env:
            DEEPSEEK_API_KEY: 'YOUR_DEEPSEEK_API_KEY'
            DEEPSEEK_ENABLE_WEB_FETCH: 'false'
          toolCallTimeoutMs: 80000
  ```

首次启动需要联网下载包。

### 从源码构建

从 [GitHub 仓库](https://github.com/CaelixOrbit/deepseek-search-mcp) 下载源码，在项目根目录执行：

```shell
npm ci
npm run build
```

构建产物位于 `dist`。将下方配置合并到客户端的 MCP 配置中，替换 API Key 占位符，并将 `args` 中的路径改为 `dist/index.js` 的实际绝对路径：

```yaml
- insert:
    - id: mcp-deepseek-search
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: deepseek-search
        transport: stdio
        command: node
        args: ['C:/path/to/deepseek-search-mcp/dist/index.js']
        env:
          DEEPSEEK_API_KEY: 'YOUR_DEEPSEEK_API_KEY'
          DEEPSEEK_ENABLE_WEB_FETCH: 'false'
        toolCallTimeoutMs: 80000
```

## 工具

| MCP 工具             | 对应接口                                                            |
| -------------------- | ------------------------------------------------------------------- |
| `deepseek_search`    | [联网搜索](https://api-docs.deepseek.com/zh-cn/api/search)          |
| `deepseek_web_fetch` | [网页抓取](https://api-docs.deepseek.com/zh-cn/api/fetch)，默认关闭 |

搜索支持站点、语言和时间范围筛选。完整参数和搜索语法见 [DeepSeek 联网搜索指南](https://api-docs.deepseek.com/zh-cn/guides/search/)及上方接口文档。

## 环境变量

| 变量                        | 规则                                             |
| --------------------------- | ------------------------------------------------ |
| `DEEPSEEK_API_KEY`          | 必填，使用 DeepSeek 开放平台 API Key             |
| `DEEPSEEK_ENABLE_WEB_FETCH` | 控制是否启用 `deepseek_web_fetch` 工具，默认关闭 |

考虑到不少 Agent 软件已经自带网页抓取（web_fetch）功能，需要付费使用的 `deepseek_web_fetch` 工具默认关闭，也不会出现在客户端的工具列表中。需要时，可将 `DEEPSEEK_ENABLE_WEB_FETCH` 设置为 `"true"` 来开启。

## 费用

调用使用 DeepSeek 开放平台账户额度。具体价格和计费规则见 [DeepSeek 联网搜索指南](https://api-docs.deepseek.com/zh-cn/guides/search/#%E8%AE%A1%E8%B4%B9)。

## 许可证

MIT，Copyright (c) 2026 Caelix。