MCP Web Search

🚀 网络搜索 MCP 服务器

本项目是一个 MCP 服务器，提供 Google 搜索功能和网页内容查看服务，同时具备强大的高级反爬虫机制，有效保障搜索和内容查看的稳定与安全。

🚀 快速开始

在开始使用本项目前，你需要满足以下先决条件：

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

✨ 主要特性

• Google 自定义搜索：支持高级过滤，可精准定位所需信息。
• 网页内容查看：带有 Markdown 转换功能，方便查看和处理网页内容。
• 限流与缓存：优化服务器性能，减少不必要的请求。
• 浏览器实例池：提高资源利用率，加快搜索和内容查看速度。
• 反爬虫检测：使用 rebrowser - puppeteer 技术，有效绕过网站的反爬虫机制。

📦 安装指南

# 开发模式运行并监听文件变化
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
  }
}

注意事项

⚠️ 重要提示

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

💡 使用建议

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

📄 许可证

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