Claude Chrome MCP

Claude Chrome MCP

浏览器自动化工具，可通过 Chrome 扩展和 MCP 服务，让 MCP 客户端（Claude Desktop、Claude Code、Cursor）与 claude.ai 交互。

组件

• MCP 服务
• Chrome 扩展（仅在 claude.ai 上启用）
• 命令行工具

快速开始

前提条件

• Google Chrome 浏览器
• Node.js v16 或更高版本
• 已安装 npm

步骤 1：安装 Chrome 扩展

1. 打开 Chrome，并导航到 chrome://extensions/
2. 启用“开发者模式”（右上角的开关）
3. 点击“加载已解压的扩展程序”，并选择此项目中的 extension/ 目录
4. 扩展图标应会显示在工具栏中

步骤 2：安装依赖项

# From the project root directory
cd mcp-server
npm install

步骤 3：配置 Claude Desktop

1. 打开 Claude Desktop 设置
2. 导航到 Developer > Edit Config
3. 添加以下配置：

{
  "mcpServers": {
    "claude-chrome-mcp": {
      "command": "node",
      "args": ["<absolute-path-to-project>/mcp-server/src/server.js"]
    }
  }
}

将 <absolute-path-to-project> 替换为此项目的完整路径（例如，/Users/yourname/claude-chrome-mcp）

步骤 4：重启 Claude Desktop

添加配置后，重启 Claude Desktop 以加载 MCP 服务。服务会自动在端口 54321 上启动内嵌的 WebSocket 中继。

步骤 5：测试连接

现在，你可以在 Claude Desktop 中使用自然语言命令，例如：

• “检查 Chrome 状态”
• “打开一个新标签页”
• “向新的 Claude 标签页发送‘Hello, World!’”
• “列出所有打开的 Claude 标签页”
• “搜索包含‘math’的 Claude 对话”

主要功能

• 异步发送消息并检测完成状态
• 将 Claude 的响应转发给 Claude
• 通过 Claude.ai API 管理对话
• 网络检查和调试工具
• 采用持久连接的纯 WebSocket 架构
• 用于中继状态的健康监控端点

文档

指南	说明
架构分析	关键问题和改进路线图
架构	系统设计和组件
故障排除	完整的故障排除和超时问题解决指南
开发工作流	代码更改、测试和开发流程
TypeScript	类型定义和开发
命令行工具	命令行界面和设置
事件架构	系统可视化图示

项目资源

• MCP 配置 - 快速命令和设置
• GitHub Releases - 发布历史
• GitHub Issue Script - Claude Code 集成工具

命令行工具（可选）

npm install && npm run build && npm link

架构

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Claude.ai     │    │ Chrome Extension │    │ WebSocket Relay │
│   (Browser)     │◄──►┤ (Offscreen Doc)  │◄──►│   Port 54321    │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                                         ▲
                                                         │
                                                ┌────────┴────────┐
                                                │                 │
                                        ┌───────▼──────┐ ┌───────▼──────┐
                                        │ MCP Server   │ │ Claude Code  │
                                        │ (Relay Mode) │ │ MCP Client   │
                                        └──────────────┘ └──────────────┘