网络搜索 MCP 服务器

一个提供 Google 搜索功能和网页内容查看的 MCP 服务器，并具备高级反爬虫机制。

功能特性

• Google 自定义搜索：支持高级过滤
• 网页内容查看：带有 Markdown 转换功能
• 限流与缓存
• 浏览器实例池
• 反爬虫检测：使用 rebrowser-puppeteer 技术

先决条件

• Bun 运行时环境 v1.0 或更高版本
• Google API 凭证（API Key 和搜索应用 ID）

安装步骤

# 开发模式运行并监听文件变化
bun --watch run dev

# 执行测试
bun run test

# 运行代码检查
bun run lint

配置指南

1. Cookie 设置

为了实现身份验证，请按照以下步骤配置：

• Windows 系统：将 config-example.json 文件复制到 %APPDATA%\Claude\mcp-clients\web-search 目录下，并重命名为 config.json。
• Mac/Linux 系统：将文件复制到 ~/.claude/mcp-clients/web-search 并重命名为 config.json。

2. 服务器配置

在 config.json 文件中添加以下内容：

{
  "browserLimits": {
    "globalLimit": 5,
    "requesterLimit": 2
  },
  "proxySettings": {
    "useProxy": true,
    "proxyUrl": "http://your-proxy-server:port",
    "proxyEnabledForDomains": ["example.com", "another-site.com"]
  }
}

日志配置

# 查看日志文件
# MacOS/Linux 系统：
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

# Windows 系统：
type %APPDATA%\Claude\Logs\mcp*.log

反爬虫机制说明

• 请求频率限制：通过 browserLimits 配置控制并发和总请求数量。
• 代理设置：配置 proxySettings 以绕过反爬虫检测，支持指定域名使用代理。

工具接口

搜索工具

{
  name: "search",
  params: {
    query: string;          // 必填项：搜索关键词
    trustedDomains?: string[]; // 可选：可信域名列表
    excludedDomains?: string[]; // 可选：排除的域名
    resultCount?: number;   // 可选：返回结果数量，默认为 10
    safeSearch?: boolean;   // 可选：启用安全搜索，默认为 true
    dateRestrict?: string;  // 可选：时间限制，支持 "d"（过去一天）、"w"（过去一周）等选项
  }
}

网页查看工具

{
  name: "view_url",
  params: {
    url: string;            // 必填项：目标网页地址
    includeImages?: boolean; // 可选：是否包含图片，默认为 true
    includeVideos?: boolean; // 可选：是否包含视频，默认为 true
    preserveLinks?: boolean; // 可选：保持链接完整性，默认为 true
    formatCode?: boolean;   // 可选：格式化代码输出，默认为 false
  }
}

注意事项

1. 反爬虫策略：

   • 服务器内置了多种反爬虫机制，但仍需结合代理和用户代理设置以增强安全性。
   • 部分网站可能仍能检测到自动化行为。

2. 性能优化：

   • 浏览器实例池化设计可提高资源利用率
   • 智能清理空闲浏览器以避免资源耗尽

许可证信息

本项目遵循 MIT 开源协议，具体条款请参考 LICENSE 文件。