Chrome Debug MCP Playwright

一个使用Playwright实现浏览器自动化的Model Context Protocol (MCP)，支持完整的Greasemonkey API。

<a href="https://glama.ai/mcp/servers/nguhnsghor"> <img width="380" height="200" src="https://gips2.baidu.com/it/u=2894307251,762392032&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Chrome Debug Server MCP server" /> </a>

功能

核心浏览器功能

• 浏览器启动与管理
• 多标签页支持，包括创建、切换和关闭
• 页面导航与交互
• 截图捕获

Greasemonkey API 支持

• 使用GM_addStyle进行CSS注入
• 使用GM_getValue/GM_setValue进行数据存储
• 使用GM_deleteValue清理存储
• 使用GM_notification发送桌面通知
• 使用GM_setClipboard进行剪贴板操作
• 使用GM_xmlhttpRequest进行跨域请求

资源管理

• 网络请求拦截
• 请求阻断、修改和日志记录
• 资源类型过滤

调试功能

• 详细的日志系统
• 日志文件组织
• 清晰的界面输出

安装

npm install chrome-debug-mcp-playwright

快速开始

// 启动浏览器
tool browser launch_browser --url "https://example.com" --browserType "chromium"

// 使用GM函数
tool browser gm_setValue --key "setting" --value "test"
tool browser gm_getValue --key "setting"

// 拦截请求
tool browser intercept_requests --patterns ["*.jpg", "*.css"] --action "block"

文档

• 命令 - 包含示例的详细命令文档
• 在COMMANDS.md中提供完整的命令列表及使用示例

核心功能

浏览器管理

// 启动浏览器
tool browser launch_browser --url "https://example.com"

// 创建新标签页
tool browser create_tab --url "https://example.com"

// 切换标签页
tool browser switch_tab --index 1

Greasemonkey API

// 添加自定义样式
tool browser gm_addStyle --css "body { background: #f0f0f0; }"

// 存储数据
tool browser gm_setValue --key "setting" --value "test"

// 发起跨域请求
tool browser gm_xmlhttpRequest --url "https://api.example.com/data" --method "GET"

资源拦截

// 阻止图片加载
tool browser intercept_requests --patterns ["*.jpg", "*.png"] --action "block"

// 记录所有CSS请求
tool browser intercept_requests --patterns ["*.css"] --action "log"

实现细节

日志系统

• 所有调试输出重定向到日志文件
• 带时间戳的条目
• 组织在logs目录下
• 清晰的界面输出

错误处理

• 详细的错误日志
• 错误时适当的清理
• 资源管理

依赖项

• Playwright：浏览器自动化
• @modelcontextprotocol/sdk：MCP实现

开发

先决条件

• Node.js 16或更高版本
• npm 7或更高版本

设置

git clone https://github.com/yourusername/chrome-debug-mcp-playwright.git
cd chrome-debug-mcp-playwright
npm install

许可证

MIT许可证 - 详情见LICENSE文件。

贡献

我们欢迎贡献！请参阅我们的贡献指南以获取详细信息。

致谢

基于原始的chrome-debug-mcp由Robert Headley创建。