Claude Code Browser MCP Setup

MCP开发工具

提供方 haasonsaas · 包名 @modelcontextprotocol/server-chrome-devtools

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

通过Chrome DevTools MCP服务器实现浏览器自动化,支持页面导航、元素交互、网络监控和性能分析等功能。

一句话选型结论

按资料字段整理

Claude Code Browser MCP Setup 属于开发工具类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 13 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Shell本地部署浏览器自动化网页交互网络监控性能分析JavaScript执行

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/server-chrome-devtools

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Claude Code Browser MCP Setup当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方haasonsaas上游标注的维护方 haasonsaas
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@modelcontextprotocol/server-chrome-devtools · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.2 KB
来自项目仓库与上游目录的原文,未做删改

Claude代码浏览器MCP设置

使用Chrome DevTools MCP服务器和Claude Code实现浏览器自动化和web交互功能的文档。

概述

此设置允许Claude Code通过模型上下文协议(MCP)与Chrome浏览器交互。Chrome DevTools MCP服务器提供以下工具:

  • 页面导航和管理
  • 拍摄网页快照和截图
  • 点击、填写表单和与页面元素交互
  • 网络请求监控
  • 性能分析
  • 浏览器上下文中的JavaScript执行

安装

1.安装Chrome DevTools MCP服务器```bash

npm install -g @modelcontextprotocol/server-chrome-devtools


或者使用npx(无需安装):```bash
npx @modelcontextprotocol/server-chrome-devtools

2.配置克劳德代码

将MCP服务器添加到Claude Code配置文件中 ~/.config/claude/claude_desktop_config.json:```json
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-chrome-devtools"
]
}
}
}


如果全局安装,则可以使用:```json
{
"mcpServers": {
"chrome-devtools": {
"command": "mcp-server-chrome-devtools"
}
}
}

3.通过远程调试启动Chrome

MCP服务器通过Chrome DevTools协议连接到Chrome。您需要在启用远程调试的情况下启动Chrome:

macOS:```bash
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222


**Linux:**```bash
google-chrome --remote-debugging-port=9222

窗户:```bash
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222


### 4.重新启动克劳德代码

配置后,重新启动Claude Code以加载MCP服务器。

## 可用工具

Chrome DevTools MCP提供以下工具(均以前缀 `mcp__chrome-devtools__`):

### 页面管理

- `list_pages` -列出所有打开的浏览器选项卡
- `select_page` -按索引选择特定选项卡
- `new_page` -使用URL打开新选项卡
- `navigate_page` -将当前选项卡导航到URL
- `navigate_page_history` -历史回顾/前进
- `close_page` -关闭选项卡
- `resize_page` -调整浏览器窗口大小

### 页面检查

- `take_snapshot` -使用元素的UID获取页面的文本快照
- `take_screenshot` -捕获页面或元素的屏幕截图
- `evaluate_script` -在页面上下文中执行JavaScript

### 交互

- `click` -单击元素(按快照中的UID)
- `fill` -在输入字段中键入
- `fill_form` -一次填写多个表单字段
- `hover` -将鼠标悬停在元素上
- `drag` -拖放元素
- `upload_file` -通过文件输入上传文件
- `handle_dialog` -处理浏览器警报/确认/提示

### 网络

- `list_network_requests` -获取自上次导航以来的所有网络请求
- `get_network_request` -通过URL获取特定请求的详细信息
- `emulate_network` -模拟网络条件(3G、4G、离线)

### 演出

- `performance_start_trace` -开始性能录制
- `performance_stop_trace` -停止录制并获取结果
- `performance_analyze_insight` -获取详细的性能见解
- `emulate_cpu` -节流CPU进行测试

### 控制台

- `list_console_messages` -获取控制台日志、警告、错误

### 等待

- `wait_for` -等待特定文本出现在页面上

## 典型工作流程

1. **列出并选择页面:**```
list_pages → select_page(0)
  1. 导航到URL:```
    navigate_page("https://example.com")

1. **拍摄快照以查看页面结构:**```
take_snapshot → Returns UIDs for all interactive elements
  1. 与元素交互:```
    click(uid="1_28")
    fill(uid="1_86", value="search term")

1. **监控网络活动:**```
list_network_requests → See all API calls, resources loaded

示例用例

1.浏览黑客新闻```

  1. navigate_page("https://news.ycombinator.com")
  2. take_snapshot
  3. Read headlines and decide what to click
  4. click(uid_of_interesting_article)
  5. take_snapshot to read the article

### 2.发布到推特/X```
1. navigate_page("https://x.com")
2. take_snapshot
3. fill(uid_of_tweet_box, "Your tweet content")
4. click(uid_of_post_button)

3.自动化测试```

  1. navigate_page("http://localhost:3000")
  2. take_screenshot for visual comparison
  3. fill_form with test data
  4. click submit button
  5. wait_for("Success message")
  6. list_console_messages to check for errors

### 4.性能分析```
1. performance_start_trace(reload=true, autoStop=true)
2. Wait for trace to complete
3. performance_analyze_insight("LCPBreakdown")
4. Get detailed Core Web Vitals data

提示和最佳实践

  1. 始终先拍摄快照 -在与页面交互之前,拍摄快照以查看可用元素及其UID。

  2. 使用特定的UID -每个元素在快照中都有一个唯一的UID。始终使用这些进行可靠的交互。

  3. 处理动态内容 -使用 wait_for 当在导航或交互后等待内容加载时。

  4. 网络监控 -在导航以捕获所有请求之前启用网络监控。

  5. 错误处理 -检查控制台消息 list_console_messages 调试问题。

  6. 清理 -关闭您已使用完毕的选项卡 close_page 以保持浏览器的可管理性。

故障排除

MCP服务器未连接

  • 确保Chrome正在运行 --remote-debugging-port=9222
  • 检查是否没有其他进程正在使用端口9222
  • 尝试重新启动Chrome和Claude Code

未找到元素

  • 在单击之前拍摄一张新的快照-UID会在页面更新时更改
  • 在拍摄快照之前,确保页面已完全加载
  • 使用 wait_for 用于动态内容

超时

  • 增加导航调用中的超时参数
  • 检查网络状况-使用 emulate_network 测试
  • 验证页面是否正在Chrome中实际加载

安全说明

  • 远程调试端口(9222)允许完全控制浏览器
  • 仅在受信任的网络上使用
  • 不要将调试端口暴露给外部网络
  • 考虑使用单独的Chrome配置文件进行自动化

其他资源

  • Chrome DevTools协议文档
  • 模型上下文协议规范
  • Claude代码文档

会话示例

以下是我们会议中的一个真实示例:

  1. 首先浏览Hacker News以查找有趣的文章
  2. 找到了一篇关于正式验证代码的文章
  3. 点击阅读全文
  4. 导航到推特/X
  5. 撰写并发布了一条关于这篇文章的推文,其中包含了关键见解

所有这些都是通过使用自然语言命令的Claude Code完成的,MCP服务器在幕后处理浏览器自动化。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Claude Code Browser MCP Setup 怎么安装?

在客户端按下面的安装命令接入:npx @modelcontextprotocol/server-chrome-devtools。对应的包名是 @modelcontextprotocol/server-chrome-devtools。装完在客户端配置里引用同一个包或端点。

Claude Code Browser MCP Setup 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Claude Code Browser MCP Setup 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Claude Code Browser MCP Setup 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Claude Code Browser MCP Setup 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Claude Code Browser MCP Setup 能提供哪些能力?

资料显示能力标签包括 浏览器自动化、网络监控、Shell、Claude、网页交互。具体工具清单以官方文档为准。

Claude Code Browser MCP Setup 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Claude Code Browser MCP Setup 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。