内容
# 网页搜索MCP
多提供者联网搜索 MCP 服务器。当前支持豆包（火山引擎[联网搜索 API](https://www.volcengine.com/docs/87772/2272953?lang=zh)）。
## 安装
### 从 npm 使用（推荐）
```bash
npx @fuyouai/web-search-mcp --provider 豆包
```
### 本地开发
```bash
npm install
npm run build
```
## Cursor 配置
在项目或全局 `.cursor/mcp.json` 中添加：
```json
{
"mcpServers": {
"网页搜索-豆包": {
"command": "npx",
"args": ["-y", "@fuyouai/web-search-mcp", "--provider", "豆包"],
"env": {
"豆包API密钥": "${env:豆包API密钥}"
}
}
}
}
```
本地开发时也可指向编译产物：
```json
{
"mcpServers": {
"网页搜索-豆包": {
"command": "node",
"args": ["/绝对路径/to/web_search_mcp/dist/index.js", "--provider", "豆包"],
"env": {
"豆包API密钥": "${env:豆包API密钥}"
}
}
}
}
```
## 环境变量
| 变量 | 必填 | 说明 |
|------|------|------|
| `豆包API密钥` | 是 | 火山引擎联网搜索 API 密钥 |
| `豆包基础地址` | 否 | 默认 `https://open.feedcoopapi.com` |
| `网页搜索提供者` | 否 | 未传 `--provider` 时的备用方案 |
API 密钥可在[火山控制台](https://console.volcengine.com/search-infinity/api-key)创建。
## MCP 工具
### `网页搜索`
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `查询词` | 字符串 | 是 | 搜索词，1~100 字符 |
| `返回条数` | 数字 | 否 | 返回条数，网页最多 50，图片最多 5 |
| `搜索类型` | 字符串 | 否 | `网页` 或 `图片`，默认 `网页` |
| `时间范围` | 字符串 | 否 | `一天` / `一周` / `一个月` / `一年` 或 `YYYY-MM-DD..YYYY-MM-DD` |
| `权威级别` | 数字 | 否 | `0` 默认，`1` 非常权威 |
## 本地调试
```bash
export 豆包API密钥=你的密钥
node dist/index.js --provider 豆包 --log-level 调试
```
## 启动参数
```bash
node dist/index.js --provider 豆包 [--默认限制 10] [--日志级别 信息]
```
