# web-search-mcp

多 provider 联网搜索 MCP Server。当前支持豆包（火山引擎[联网搜索 API](https://www.volcengine.com/docs/87772/2272953?lang=zh)）。

## 安装

### 从 npm 使用（推荐）

```bash
npx @fuyouai/web-search-mcp --provider doubao
```

### 本地开发

```bash
npm install
npm run build
```

## Cursor 配置

在项目或全局 `.cursor/mcp.json` 中添加：

```json
{
  "mcpServers": {
    "web-search-doubao": {
      "command": "npx",
      "args": ["-y", "@fuyouai/web-search-mcp", "--provider", "doubao"],
      "env": {
        "DOUBAO_API_KEY": "${env:DOUBAO_API_KEY}"
      }
    }
  }
}
```

本地开发时也可指向编译产物：

```json
{
  "mcpServers": {
    "web-search-doubao": {
      "command": "node",
      "args": ["/absolute/path/to/web_search_mcp/dist/index.js", "--provider", "doubao"],
      "env": {
        "DOUBAO_API_KEY": "${env:DOUBAO_API_KEY}"
      }
    }
  }
}
```

## 环境变量

| 变量 | 必填 | 说明 |
|------|------|------|
| `DOUBAO_API_KEY` | 是 | 火山引擎联网搜索 API Key |
| `DOUBAO_BASE_URL` | 否 | 默认 `https://open.feedcoopapi.com` |
| `WEB_SEARCH_PROVIDER` | 否 | 未传 `--provider` 时的 fallback |

API Key 可在[火山控制台](https://console.volcengine.com/search-infinity/api-key)创建。

## MCP Tool

### `web_search`

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `query` | string | 是 | 搜索词，1~100 字符 |
| `count` | number | 否 | 返回条数，web 最多 50，image 最多 5 |
| `searchType` | string | 否 | `web` 或 `image`，默认 `web` |
| `timeRange` | string | 否 | `OneDay` / `OneWeek` / `OneMonth` / `OneYear` 或 `YYYY-MM-DD..YYYY-MM-DD` |
| `authLevel` | number | 否 | `0` 默认，`1` 非常权威 |

## 本地调试

```bash
export DOUBAO_API_KEY=your_key
node dist/index.js --provider doubao --log-level debug
```

## 启动参数

```bash
node dist/index.js --provider doubao [--default-limit 10] [--log-level info]
```