Chrome Pilot

Chrome MCP服务器

一个模型上下文协议（MCP）服务器，使克劳德等人工智能助手能够通过Chrome扩展程序和WebSocket通信控制Chrome浏览器。非常适合跨平台自动化，特别是WSL/Windows设置。

🚀 特性

• 浏览器自动化：导航、单击、滚动、填写表单、截图
• 交叉平台的：跨WSL/Windows网络边界工作
• 双重通信：本地消息传递+WebSocket（网络）
• 克劳德集成：与Claude Code和Claude Desktop直接集成
• 实时控制：通过MCP工具进行实时浏览器交互
• Chrome 扩展：易于安装带有弹出控件的浏览器扩展

🏗️ 建筑

┌─────────────┐    WebSocket     ┌─────────────┐    MCP/stdio    ┌─────────────┐
│   Windows   │ ←─────────────→  │     WSL     │ ←─────────────→ │ Claude Code │
│   Chrome    │   ws://IP:9222   │   Server    │                 │             │
│ + Extension │                  │             │                 │             │
└─────────────┘                  └─────────────┘                 └─────────────┘

📦 安装

先决条件

• Node.js>=18.0.0
• Chrome/Chromium浏览器
• TypeScript（用于开发）

快速设置

1. 克隆存储库

   git clone https://github.com/deoxy/chrome-pilot.git
   cd chrome-pilot

1. 安装依赖项

   cd server
   npm install
   npm run build

1. 启动WebSocket服务器

   node dist/index.js --websocket

1. 加载Chrome扩展程序

- 打开 chrome://extensions/ - 启用“开发人员模式” - 点击“加载解包” - 选择 extension 文件夹

1. 配置扩展

- 点击扩展图标 - 输入WebSocket URL： ws://YOUR_IP:9222/ws - 点击“保存配置”和“重新连接”

🔧 配置

克劳德代码（WSL）

增添 ~/.claude/settings.json:

{
  "mcpServers": {
    "chrome-pilot": {
      "command": "node",
      "args": ["/path/to/chrome-pilot/server/dist/index.js", "--websocket"],
      "env": {}
    }
  }
}

适用于克劳德桌面

添加到Claude桌面设置：

{
  "mcpServers": {
    "chrome-pilot": {
      "command": "node",
      "args": ["/path/to/chrome-pilot/server/dist/index.js"]
    }
  }
}

🛠️ 可用工具

🌐 网络设置（WSL/Windows）

1.查找WSL IP

ip route | grep default

2.配置Windows防火墙

# Run as Administrator
New-NetFirewallRule -DisplayName "Chrome MCP Server" -Direction Inbound -Port 9222 -Protocol TCP -Action Allow

3.扩展设置

1. 通过访问扩展 \\wsl$\Ubuntu\path\to\chrome-pilot\extension
2. 在Windows Chrome中加载
3. 在弹出窗口中配置WebSocket URL
4. 测试连接

🧪 测试

测试WebSocket服务器

curl http://localhost:9222/info
curl -X POST http://localhost:9222/command \
  -H "Content-Type: application/json" \
  -d '{"action": "get_tabs", "params": {}}'

与克劳德一起测试

Can you navigate to google.com and take a screenshot?

📁 项目结构

chrome-pilot/
├── server/                 # MCP Server (TypeScript)
│   ├── src/
│   │   ├── index.ts        # Main server entry
│   │   ├── websocket-server.ts    # WebSocket server
│   │   ├── native-host.ts  # Native messaging
│   │   └── tools/          # Browser automation tools
│   ├── package.json
│   └── tsconfig.json
├── extension/              # Chrome Extension
│   ├── manifest.json       # Extension config
│   ├── background-websocket.js   # Service worker
│   ├── content.js          # Content script
│   ├── popup.html          # Extension popup
│   └── popup.js
├── native-host/            # Native messaging setup
│   ├── install.sh          # Installation script
│   └── com.chrome_mcp.host.json.template
└── docs/                   # Documentation

🔍 故障排除

扩展未连接

• 在扩展弹出窗口中验证WebSocket URL
• 检查WSL IP地址是否未更改
• 确保服务器在正确的端口上运行
• 检查Windows防火墙设置

MCP工具不工作

• 重新启动Chrome扩展程序
• 在弹出窗口中验证“已连接”状态
• 检查服务器日志是否有错误
• 确保扩展具有必要的权限

性能问题

• 使用以太网连接以获得最佳性能
• 监控WSL和Windows之间的网络延迟
• 考虑在固定IP上运行

🤝 贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

📝 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• 内置于 MCP-SDK 通过Anthropic
• 使用Chrome扩展程序API实现浏览器自动化
• 支持跨平台的WebSocket通信

📞 支持

• 创建一个 问题 用于错误报告
• 检查 文档 获取详细指南
• 看 网络设置指南 用于WSL/Windows配置