MCP Browser Automation Server (mcp-browser-automation-server)

🎮 MCP浏览器自动化服务器

🌟 描述

的Web自动化服务器 操纵者 允许任何 LLM 通过远程控制浏览器 API REST简单.在实验过程中开发 模型上下文协议（MCP） 用于远程桌面和Web任务的自动化。

✨ 主要特征

• 🌐 完整的浏览器控制 通过API REST
• 📸 屏幕截图automáticos 轴承内容分析
• 🎯 智能点击系统 （文本和坐标）
• ⌨️ 文本输入和键 自动匹配编码
• 🕵️ 隐藏模式 避免检测机器人
• 🧠 工作流程备忘录 诈骗检查站
• ⏱️ 超时智能 和自动恢复
• 🎨 完整系统屏幕截图 （Windows PowerShell）

🚀 快速安装

1.先决条件

# Node.js 16+ requerido
node --version
npm --version

2. 安装依赖关系

npm install puppeteer puppeteer-extra puppeteer-extra-plugin-stealth express cors

3.运行服务器

node browser-server-enhanced-v2.js

4.准备好了！

服务器运行在： http://localhost:3002

📚 api参考

🚀 启动浏览器

curl "http://localhost:3002/launch?url=https://google.com"

📸 Capturar截图

curl "http://localhost:3002/screenshot?description=mi-screenshot"

🎯 按坐标单击

curl "http://localhost:3002/clickCoordinates?x=400&y=300"

👆 按文本单击

curl "http://localhost:3002/clickText?text=Buscar"

⌨️ 写文字

curl "http://localhost:3002/type?text=Hola%20mundo"

🔑 按下键

curl "http://localhost:3002/pressKey?key=Enter"

🤖 与LLMS一起使用

克劳德代码（MCP）

# Ejemplo de flujo completo para buscar en Google
curl -s "http://localhost:3002/launch?url=https://google.com"
curl -s "http://localhost:3002/clickCoordinates?x=384&y=300"
curl -s "http://localhost:3002/type?text=inteligencia%20artificial"
curl -s "http://localhost:3002/pressKey?key=Enter"
curl -s "http://localhost:3002/screenshot?description=resultados-busqueda"

任何LLM

LLM可以使用命令 curl 简单段落：

1. 兰扎 网页
2. 互动 与元素（点击，文本）
3. 船长 屏幕截图与分析
4. Navegar 帕索，帕索

📁 项目结构

📂 Proyecto MESSH/
├── 📄 browser-server-enhanced-v2.js    # Servidor principal
├── 📄 take-screenshot.ps1              # Screenshots sistema (Windows)
├── 📄 README.md                        # Esta documentación
├── 📄 package.json                     # Dependencias npm
├── 📄 EXAMPLES.md                      # Ejemplos de uso
└── 📂 screenshots/                     # Capturas guardadas
    ├── enhanced-v2-*.png
    └── screenshot-sistema-completo.png

🎯 使用案例

✅ Web 自动化

• 谷歌搜索
• 填写表格
• 网站导航
• 报废数据

✅ 自动化测试

• 用户界面测试
• 流程验证
• 回归捕获

✅ 控制远程

• 埃斯克里托里奥斯·雷莫托斯（MeshCentral）
• 虚拟机在线（JSLinux、DistroSea）
• Web 应用程序

🔧 高级设置

Modo隐形（反机器人）

// Ya incluido en browser-server-enhanced-v2.js
const StealthPlugin = require('puppeteer-extra-plugin-stealth')
puppeteer.use(StealthPlugin())

系统截图（Windows）

# Ejecutar para capturas completas incluyendo iframes
powershell -ExecutionPolicy Bypass -File take-screenshot.ps1

🎓 项目经验教训

🔍 技术发现

• 木偶+iframe：捕获不显示iFrames内容
• PowerShell屏幕截图：捕获整个系统，包括iFrames
• MeshCentral遥控器：按坐标单击效果更好
• VM限制：jslinux/Distrosea有连接限制

🏗️ MCP结构

1. 执行 → 埃斯佩拉尔 → 截图 → 分析 → 裁判
2. 工作流程备忘录 con检查点恢复
3. API REST简单 任何LLM都可以使用
4. 超时智能 对于动态元素

🚨 已知限制

• ⚠️ 内嵌框架：Puppeteer不捕获iFrames内容
• ⚠️ 虚拟机在线：模拟器中的连接受限
• ⚠️ 机器人检测：一些网站可能会阻止
• ⚠️ 仅限Windows：PowerShell屏幕截图单独在Windows

🤝 贡献

1. 叉库
2. 为您的功能创建分支
3. 提交您的更改
4. 推拉拉马
5. 取消拉取请求

📄 许可证

麻省理工学院许可证-随时使用、修改和分发。

🙏 学分

在实验过程中开发 克劳德代码 y 模型上下文协议 用于浏览器和远程桌面的自动化。非常适合与任何可以执行HTTP命令的LLM集成。

______________________________________________________________________

💡 小贴士：该服务器特别适用于可以访问命令行工具的LLM，例如 curl 英语字母表的第15个字母 Bash.