Chrome MCP Server
Chrome浏览器控制MCP服务器，为Cursor提供强大的浏览器自动化功能。
📚 用户指南
小白用户专用文档
推荐阅读顺序：快速上手 → 安装配置 → 小白指南 → 常见问题
功能特性
🌐 页面导航
- chrome_navigate: 导航到指定URL
- chrome_search: 使用Bing搜索引擎搜索内容（适合国内使用）
- chrome_wait_for_element: 等待页面元素加载
📸 内容获取
- chrome_screenshot: 页面截图（支持全页面截图）
- chrome_get_content: 获取页面内容或指定元素内容
🖱️ 页面交互
- chrome_click: 点击页面元素
- chrome_type: 在输入框中输入文本
- chrome_scroll: 页面滚动控制
🔧 浏览器管理
- chrome_close: 关闭浏览器实例
安装依赖
cd chrome-mcp-server
npm install使用示例
1. 直接搜索（推荐）
// 使用Bing搜索引擎直接搜索
await chrome_search({
"query": "嵌入式入门条件"
})
// 截取搜索结果页面
await chrome_screenshot({
"fullPage": true,
"quality": 90
})2. 手动导航和操作
// 导航到网页
await chrome_navigate({
"url": "https://www.bing.com",
"waitUntil": "networkidle2"
})
// 在搜索框输入文本
await chrome_type({
"selector": "#sb_form_q",
"text": "人工智能",
"clear": true
})
// 点击搜索按钮
await chrome_click({
"selector": "#search_icon"
})
// 等待结果加载
await chrome_wait_for_element({
"selector": "#b_results",
"timeout": 10000
})3. 获取页面内容
// 获取整个页面内容
await chrome_get_content({})
// 获取特定元素内容
await chrome_get_content({
"selector": ".result h3"
})4. 页面滚动
// 向下滚动
await chrome_scroll({
"direction": "down",
"distance": 500,
"smooth": true
})
// 滚动到页面顶部
await chrome_scroll({
"direction": "top"
})配置说明
在Cursor的mcp.json配置文件中已添加Chrome MCP服务器：
{
"mcpServers": {
"Chrome-Browser": {
"disabled": false,
"timeout": 120,
"command": "node",
"args": [
"D:\\code\\hd-backend\\chrome-mcp-server\\index.js"
],
"env": {
"NODE_ENV": "production"
}
}
}
}技术架构
核心组件
- ChromeController: 浏览器控制核心类
- MCP Server: 协议处理和工具注册
- Puppeteer: Chrome浏览器自动化引擎
安全特性
- 错误处理和超时控制
- 优雅关闭机制
- 详细的日志记录
性能优化
- 单例浏览器实例
- 智能等待策略
- 内存管理优化
开发规范
遵循项目的开发规范要求：
- ✅ SOLID原则设计
- ✅ 完善的错误处理和监控
- ✅ 详细的代码注释
- ✅ 简单可控的解决方案
- ✅ 飞书平台集成规范
故障排除
常见问题
- 浏览器启动失败
- 检查Chrome是否正确安装 - 确认系统权限设置 - 查看错误日志信息
- 元素定位失败
- 验证CSS选择器正确性 - 增加等待时间 - 检查页面加载状态
- 截图失败
- 确认页面完全加载 - 检查内存使用情况 - 调整截图参数
调试模式
启动时设置环境变量启用调试：
DEBUG=true node index.js版本历史
- v1.0.0: 初始版本，支持基础浏览器控制功能