Content
# 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]
```
