chrome-pilot-mcp
通过 CDP（Chrome DevTools Protocol）连接已运行的 Chrome，并以 MCP 服务的形式暴露浏览器控制能力。
项目基于 patchright-core，适合需要保留登录态、Cookie、浏览器扩展和现有标签页的自动化场景。
核心特点
- 连接已有 Chrome 实例，无需重新启动浏览器。
- 保留登录态、用户数据和当前标签页上下文。
- 基于 patchright-core，尽量降低常见 CDP 自动化指纹。
- 提供连接、标签页、导航、交互、检视、表单等 18 个 MCP 工具。
安装
Claude Code（推荐）
# 全局安装
claude mcp add --scope user chrome-pilot -- npx -y chrome-pilot-mcp
# 项目级安装
claude mcp add --scope project chrome-pilot -- npx -y chrome-pilot-mcp--scope user 写入 ~/.claude/settings.json，--scope project 写入 .claude/settings.local.json。
通过 npx 直接运行
npx -y chrome-pilot-mcp手动配置
{
"mcpServers": {
"chrome-pilot": {
"command": "npx",
"args": ["-y", "chrome-pilot-mcp"]
}
}
}从源码运行
git clone <repo-url>
cd chrome-pilot-mcp
npm install
npm run build
npm start前置条件
Node.js / npx
npx 用于 Claude Code 启动 MCP 子进程。请先确认 Node.js 与 npx 可用（Node >= 18）：
node -v
npx -v如果缺失可按平台安装 Node.js（安装后会包含 npx）：
# macOS
brew install node
# Ubuntu / Debian
sudo apt-get update && sudo apt-get install -y nodejs npm
# Windows (PowerShell)
winget install OpenJS.NodeJS.LTSChrome 版本
需要 Chrome >= 144，以支持通过 chrome://inspect/#remote-debugging 启用远程调试。
启用远程调试
在 Chrome 地址栏打开 chrome://inspect/#remote-debugging 并启用远程调试。Chrome 重启后通常需要重新启用。
DevToolsActivePort 路径
| 平台 | 路径 | | --- | --- | | macOS | ~/Library/Application Support/Google/Chrome/DevToolsActivePort | | Linux | ~/.config/google-chrome/DevToolsActivePort | | Windows | %LOCALAPPDATA%\\Google\\Chrome\\User Data\\DevToolsActivePort |
工具概览
| 类别 | 工具 | 用途 | | --- | --- | --- | | 连接 | chrome_status, chrome_connect, chrome_disconnect | 管理 Chrome 连接状态 | | 标签页 | chrome_list_tabs, chrome_select_tab, chrome_close_tab | 查看并切换标签页 | | 导航 | chrome_navigate, chrome_back, chrome_forward, chrome_reload | 执行页面导航 | | 交互 | chrome_click, chrome_type, chrome_scroll, chrome_press_key | 与页面元素交互 | | 检视 | chrome_screenshot, chrome_dump_dom, chrome_evaluate | 截图并检查页面状态 | | 表单 | chrome_fill_form, chrome_select_option | 批量填写表单 |
详细文档
- 中文使用手册：docs/usage.md
- English usage guide: docs/usage.en.md
License
MIT
