Wsl Chrome MCP

MCP浏览器工具

提供方 477174

浏览器工具 stdio · 本地进程 会话登录 社区 / 第三方 Claude
查看接入方式

WSL Chrome MCP 是一个基于 Chrome DevTools Protocol (CDP) 的服务,提供33种浏览器自动化工具,支持会话隔离和共享模式,适用于浏览器测试和自动化任务。

一句话选型结论

按资料字段整理

Wsl Chrome MCP 属于浏览器工具类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

浏览器自动化Python本地部署ChromeDevToolsWSL会话隔离网络监控

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
uv run pytest

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 33 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
自动操作网页

打开页面、点击、填表,把浏览器动作交给模型执行。

抓取结构化数据

把页面内容整理成表格或 JSON,省掉手工复制粘贴。

关键流程回归

按步骤检查页面是否正常,回归时少漏环节。

选择建议

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

值得选的地方

  • 资料标注 33 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Wsl Chrome MCP当前 33 stdio · 本地进程 本地部署 有 2026-05-17
Playwright MCP Server 21 stdio · 本地进程 本地部署 有 2026-05-18
Fetch 9a2682de 1 SSE · 服务端推送 支持远程部署 有 2026-05-18
Browser 738d52bc 未标注 stdio · 本地进程 本地部署 有 2026-05-17
MCP 40600ece 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Skyvern MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

WSL Chrome MCP

Chrome DevTools协议(CDP)服务器 模型上下文协议,专为WSL设计。每个MCP会话在Windows上都有自己的隔离Chrome实例——没有标签冲突,会话之间没有数据泄漏。

主要特点

  • 每会话Chrome隔离 --每个MCP客户端会话都会使用临时配置文件启动自己的Chrome进程。会话不能相互干扰或干扰您的个人浏览器。
  • 配置文件模式 --您可以选择使用窗口范围的选项卡隔离在会话之间共享单个Chrome实例,从而保留您的登录状态和书签。
  • 33个浏览器自动化工具 --导航、输入、屏幕截图、可访问性快照、JavaScript执行、网络监控、性能跟踪、设备仿真。
  • 持久CDP连接 --使用自动重试(3次尝试)、PowerShell中继回退和HTTP代理作为最后手段的直接WebSocket连接。
  • TUI配置仪表板 --交互式终端用户界面(wsl-chrome-mcp config)用于管理所有设置。
  • WSL2镜像网络 --本地支持WSL2的镜像网络模式(本地主机访问Windows)。
  • 始终在CDP上 --可选模式,通过注入永久启用Chrome的调试端口 --remote-debugging-port 进入Windows快捷方式和注册表协议处理程序。

安装```bash

Clone the repository

git clone https://github.com/477174/wsl-chrome-mcp.git
cd wsl-chrome-mcp

Install with uv (recommended)

uv pip install -e .


### 添加到您的MCP客户端

**克劳德代码:**```bash
claude mcp add wsl-chrome-mcp -- uv run wsl-chrome-mcp

手动配置 (~/.config/claude-code/mcp.json 或同等):```json
{
"mcpServers": {
"wsl-chrome-mcp": {
"command": "uv",
"args": ["run", "--directory", "/path/to/wsl-chrome-mcp", "wsl-chrome-mcp"]
}
}
}


## 可用工具(33)

### 会话管理(3)

|工具|说明|
|------|-------------|
| `chrome_session_start` |使用可选URL启动Chrome会话|
| `chrome_session_list` |列出所有活动会话|
| `chrome_session_end` |结束会话并清理其Chrome实例|

### 导航(7)

|工具|说明|
|------|-------------|
| `navigate_page` |导航到URL并等待加载|
| `list_pages` |列出所有打开的页面/选项卡|
| `select_page` |切换到其他页面/选项卡|
| `new_page` |打开新页面/选项卡|
| `close_page` |关闭页面/选项卡|
| `resize_page` |调整浏览器视口大小|
| `handle_dialog` |接受或关闭JavaScript对话框(警报、确认、提示)|

### 输入(8)

|工具|说明|
|------|-------------|
| `click` |按可访问性UID单击元素|
| `click_at` |单击特定的x、y坐标|
| `fill` |按UID在输入字段中键入文本|
| `fill_form` |一次填写多个表单字段|
| `hover` |按UID将鼠标悬停在元素上|
| `drag` |从一个元素拖动到另一个元素|
| `press_key` |按键盘键(Enter、Tab、快捷键)|
| `upload_file` |将文件上传到文件输入元素|

### 快照和等待(2)

|工具|说明|
|------|-------------|
| `take_snapshot` |使用UID将可访问性树捕获为结构化文本,用于元素定位|
| `wait_for` |等待与文本/角色匹配的元素出现|

### 屏幕截图和PDF(2)

|工具|说明|
|------|-------------|
| `take_screenshot` |截图(视口、整页或特定元素)|
| `generate_pdf` |生成当前页面的PDF|

### 脚本(3)

|工具|说明|
|------|-------------|
| `evaluate` |在页面上下文中执行JavaScript表达式或函数|
| `get_html` |获取页面或特定元素的HTML内容|
| `scroll` |滚动页面或特定元素|

### 监控(4)

|工具|说明|
|------|-------------|
| `get_console` |通过筛选获取控制台消息(日志、警告、错误)|
| `get_console_message` |按索引获取特定的控制台消息|
| `get_network` |通过URL、方法、状态过滤获取网络请求|
| `get_network_request` |获取特定网络请求的详细信息|

### 仿真(1)

|工具|说明|
|------|-------------|
| `emulate` |模拟设备、视口、暗模式、地理位置、网络限制(慢速3G、快速3G、离线)、CPU限制和自定义用户代理|

### 性能(3)

|工具|说明|
|------|-------------|
| `performance_start_trace` |启动Chrome性能跟踪|
| `performance_stop_trace` |停止跟踪并返回记录的数据|
| `performance_analyze_insight` |分析跟踪数据以获得性能见解|

## 建筑```
┌──────────────────────────────────────────────────────────────────────┐
│                            WSL Linux                                 │
│                                                                      │
│  ┌────────────────────────────────────────────────────────────────┐  │
│  │                      wsl-chrome-mcp                            │  │
│  │                                                                │  │
│  │  ┌──────────────┐    ┌──────────────────┐    ┌─────────────┐  │  │
│  │  │  MCP Server   │───>│  Pool Manager    │───>│ Persistent  │  │  │
│  │  │  (FastMCP)    │    │  (chrome_pool)   │    │ CDP Client  │  │  │
│  │  └──────────────┘    └──────────────────┘    └──────┬──────┘  │  │
│  │                                                      │         │  │
│  │  ┌──────────────┐    ┌──────────────────┐           │         │  │
│  │  │  33 Tools     │    │  Config Manager  │           │         │  │
│  │  │  (modular)    │    │  (TOML)          │           │         │  │
│  │  └──────────────┘    └──────────────────┘           │         │  │
│  └──────────────────────────────────────────────────────┼─────────┘  │
│                                                         │            │
│                          CDP over WebSocket              │            │
│                          (port 9222)                     │            │
└─────────────────────────────────────────────────────────┼────────────┘
│
┌─────────────────────────────────────────────────────────┼────────────┐
│                         Windows Host                     │            │
│                                                          │            │
│  Isolated Mode (default):          Profile Mode:         │            │
│  ┌──────────┐ ┌──────────┐        ┌──────────────────┐  │            │
│  │ Chrome 1  │ │ Chrome 2  │        │ Shared Chrome    │<─┘            │
│  │ (temp     │ │ (temp     │        │ (your profile)   │               │
│  │  profile) │ │  profile) │        │ window-scoped    │               │
│  └──────────┘ └──────────┘        └──────────────────┘               │
└──────────────────────────────────────────────────────────────────────┘

会话模式

隔离模式(默认)

每个MCP会话都会启动一个 单独的Chrome进程 具有临时用户数据目录。会话是完全独立的——不同的Cookie、存储和历史记录。会话结束后,临时配置文件将被删除。

  • 不会干扰您的个人Chrome浏览器
  • 并发MCP会话之间没有干扰
  • 每次清洁状态```toml
    [chrome]
    profile_mode = "isolated"

### 配置文件模式

所有会话共享一个 **单个Chrome实例** 使用您现有的Chrome个人资料。每个会话都有自己的窗口,只跟踪它创建的选项卡。您的登录会话、书签和扩展都可用。

- 跨会话保留登录状态
- 访问您的书签和扩展
- 按窗口隔离的会话(不是按进程隔离的会话)```toml
[chrome]
profile_mode = "profile"
profile_name = "Profile 1"

连接策略

服务器使用具有自动回退的多层连接策略:

  1. 直接WebSocket --直接连接到Chrome的CDP WebSocket端点(重试3次,两次尝试之间延迟1秒)
  2. PowerShell中继 --如果直接连接失败,则在Windows上使用PowerShell作为WebSocket中继
  3. HTTP 代理 --最后,通过HTTP代理CDP命令

连接状态在工具响应中报告(Connected: True/False).即使有 Connected: False (代理模式),所有工具仍能正常工作。

配置

设置存储在 ~/.config/wsl-chrome-mcp/config.toml:```toml
[chrome]
debug_port = 9222 # CDP debugging port
headless = false # Run Chrome headless
profile_mode = "isolated" # "isolated" or "profile"
profile_name = "" # Chrome profile name (profile mode only)

[network]
mirrored_networking = true # WSL2 mirrored networking mode

[cdp]
always_on = false # Keep CDP enabled permanently via registry

[plugin]
installed = true # Whether OpenCode plugin is installed


### 交互式配置

运行TUI仪表板以交互方式配置所有设置:```bash
wsl-chrome-mcp config

TUI提供切换开关、下拉选择器和配置文件检测,并实时预览您的配置。

发展```bash

Install dev dependencies

uv pip install -e ".[dev]"

Run tests (98 unit tests)

uv run pytest

Run E2E concurrency test (requires Windows Chrome)

uv run pytest tests/test_isolated_concurrency.py -v

Lint and format

uv run ruff check .
uv run ruff format .

Type check

uv run mypy src


## 故障排除

### 未找到Chrome

确保Chrome已安装在Windows的以下位置之一:

- `C:\Program Files\Google\Chrome\Application\chrome.exe`
- `C:\Program Files (x86)\Google\Chrome\Application\chrome.exe`
- `%LOCALAPPDATA%\Google\Chrome\Application\chrome.exe`

### 连接被拒绝

1. 检查Chrome是否正在进行远程调试:```bash
curl http://localhost:9222/json/version
  1. Windows防火墙可能正在阻止端口9222。添加入站规则。

  2. 如果使用WSL2而不使用镜像网络,请尝试Windows主机IP:```bash
    curl http://$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):9222/json/version


### 已连接:False(代理回退)

这意味着直接WebSocket连接失败,但HTTP代理正在工作。所有工具仍正常工作。要恢复直接连接,请执行以下操作:

1. 确保Chrome正在运行 `--remote-debugging-port=9222`
1. 检查是否没有其他进程正在使用端口9222
1. 重新启动MCP服务器以重试连接

### WSL1与WSL2

此MCP针对WSL2进行了优化。对于WSL1,您可能需要使用 `localhost` 而不是Windows主机IP:```bash
export WSL_HOST_IP=127.0.0.1

许可证

麻省理工学院

学分

受...启发 chrome开发工具mcp 来自Chrome DevTools团队。

来源

  • Chrome开发工具MCP
  • Chrome DevTools协议文档
  • MCP Python SDK
  • 模型上下文协议

常见问题

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

在客户端按下面的安装命令接入:uv run pytest。装完在客户端配置里引用同一个包或端点。

Wsl Chrome MCP 怎么在 Claude 里配置?

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

Wsl Chrome MCP 收费吗?

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

Wsl Chrome MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Wsl Chrome MCP 支持哪些客户端?

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

Wsl Chrome MCP 能提供哪些能力?

资料显示约 33 个工具;能力标签包括 浏览器自动化、Python、Claude、网络监控。具体工具清单以官方文档为准。

Wsl Chrome MCP 需要什么运行环境?

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

Wsl Chrome MCP 是本地还是远程?

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

热门专题

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

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