E
Edge Browser MCP
by @torero003
Edge Browser MCP Server - Let AI assistants control Edge browser via CDP
Created 5/18/2026
Updated about 16 hours ago
README
Repository documentation and setup instructions
Edge Browser MCP Server
一个 Model Context Protocol (MCP) 服务器,让 AI 助手(如 Cline、Claude Code 等)能够通过 Chrome DevTools Protocol 控制 Microsoft Edge 浏览器。
功能
- 🌐 navigate - 导航到指定URL并获取页面内容
- 📄 get_content - 获取当前页面内容
- 📸 screenshot - 截取当前页面截图
- 📑 list_tabs - 列出所有浏览器标签页
前置要求
- Python 3.8+
- Microsoft Edge 浏览器已启用远程调试
安装
pip install websockets httpx
使用
1. 启动 Edge 浏览器(启用远程调试)
# Windows
start msedge --remote-debugging-port=9222
2. 运行 MCP Server
python index.py
3. 在 Cline 中配置
在 cline_mcp_settings.json 中添加:
{
"mcpServers": {
"edge-browser": {
"command": "python",
"args": ["-X", "utf8", "C:\\Users\\win\\Documents\\Cline\\MCP\\edge-browser\\index.py"]
}
}
}
可用工具
navigate
导航到指定URL并获取页面内容
{
"url": "https://example.com"
}
get_content
获取当前页面内容(无需参数)
screenshot
截取当前页面截图
{
"save_path": "screenshot.png"
}
list_tabs
列出所有浏览器标签页(无需参数)
更新日志
v0.2.0 (2026-05-18)
修复:
- 修复
get_content工具崩溃问题:CDP 响应存在双层result嵌套(result['result']['result']),原代码只解包一层导致KeyError: 'value' - 修复
navigate工具内容提取不正确的问题(同样的双层嵌套) - 修复 Windows 下
✓/✗等 UTF-8 字符在 GBK 编码下无法输出的问题(sys.stdout/stderr重定向为 UTF-8) - 修复
get_page_content缺少Page.enable调用,可能导致某些页面无法正确执行 JS - 修复
document.body为 null 时 JS 表达式直接崩溃的问题
改进:
- JS 表达式全部包裹 try/catch,增强错误处理
asyncio.ensure_future替换为asyncio.create_task(避免弃用警告)- 移除调试用的
sys.stderr.write日志 - 启动命令添加
-X utf8参数,确保 Windows 下 UTF-8 输出正常
许可证
MIT License
Quick Setup
Installation guide for this server
Install Package (if required)
uvx edge-browser-mcp
Cursor configuration (mcp.json)
{
"mcpServers": {
"torero003-edge-browser-mcp": {
"command": "uvx",
"args": [
"edge-browser-mcp"
]
}
}
}