chrome-pilot-mcp
Connects to a running Chrome instance via CDP to expose browser control as MCP tools, preserving login state, cookies, and extensions for automation.
README
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.LTS
Chrome 版本
需要 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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.