本项目是一个提供 Google 搜索功能和网页内容查看的 MCP 服务器,具备高级反爬虫机制,能有效应对各类网络环境,为用户提供稳定、安全的搜索服务。
本服务器提供 Google 搜索功能和网页内容查看服务,需在满足先决条件的基础上进行安装和配置。
# 开发模式运行并监听文件变化
bun --watch run dev
# 执行测试
bun run test
# 运行代码检查
bun run lint
为了实现身份验证,请按照以下步骤配置:
config-example.json
文件复制到 %APPDATA%\Claude\mcp - clients\web - search
目录下,并重命名为 config.json
。~/.claude/mcp - clients/web - search
并重命名为 config.json
。在 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 文件。