🚀 网络搜索 MCP 服务器
本项目是一个提供 Google 搜索功能和网页内容查看的 MCP 服务器，具备高级反爬虫机制，能有效应对各类网络环境，为用户提供稳定、安全的搜索服务。
🚀 快速开始
本服务器提供 Google 搜索功能和网页内容查看服务，需在满足先决条件的基础上进行安装和配置。
✨ 主要特性
- 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
}
}
注意事项
⚠️ 重要提示
- 服务器内置了多种反爬虫机制，但仍需结合代理和用户代理设置以增强安全性，部分网站可能仍能检测到自动化行为。
💡 使用建议
- 浏览器实例池化设计可提高资源利用率，同时智能清理空闲浏览器以避免资源耗尽。
📄 许可证
本项目遵循 MIT 开源协议，具体条款请参考 LICENSE 文件。