Chrome Extension Testing MCP

MCP浏览器工具

提供方 BHUVAN-RJ · 包名 chrome-extension-tester-mcp

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

一个基于MCP协议的服务器,允许通过自然语言交互式测试未打包的Chrome扩展,支持Popup交互、存储检查、网络请求监控等功能。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

浏览器自动化JavaScript本地部署扩展测试Playwright自然语言交互MCP协议

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
npx chrome-extension-tester-mcp

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

抓取结构化数据

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

关键流程回归

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

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Chrome Extension Testing MCP当前 14 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

服务器档案

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

详细介绍

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

Chrome扩展测试仪——MCP服务器

一 MCP(模型上下文协议)服务器 这让Claude可以使用Playwright交互式地测试任何未打包的Chrome扩展程序。加载您的扩展程序,与其弹出窗口和选项页面交互,检查存储,监控网络请求,检查徽章,测试消息传递等等——所有这些都是通过自然语言完成的。


目录

  • 特性
  • 需求
  • 安装
  • 使用Claude Desktop进行设置
  • 使用克劳德代码(npx)进行设置
  • 可用工具
  • 测试代理提示
  • 示例提示
  • 项目结构
  • 备注

特性

  • 加载并重新加载任何未打包的Chrome扩展程序
  • 与弹出窗口和选项页面交互(点击、键入、阅读内容)
  • 检查和操作 chrome.storage (本地/同步/会话)
  • 读取后台服务工作器控制台日志
  • 监控和检查网络请求
  • 检查并确认徽章文本和颜色
  • 向后台脚本发送消息并验证响应
  • 模拟选项卡打开/关闭/切换事件
  • 测试上下文菜单注册和处理程序调用
  • 运行返回结构化PASS/FAIL结果的断言
  • 在测试过程中随时截取屏幕截图
  • 使用一次性电子邮件在任何网站上创建和重复使用测试帐户(通过Guerrilla Mail API)

需求

  • Node.js 18岁或以上
  • 克劳德桌面版 或 克劳德代码 支持MCP
  • Chrome扩展程序 manifest.json (清单V2或V3)

安装

选项A--npx(无需安装)```bash

npx chrome-extension-tester-mcp


### 选项B--全局安装```bash
npm install -g chrome-extension-tester-mcp

选项C——克隆并在本地运行```bash

git clone https://github.com/BHUVAN-RJ/chrome-extension-testing-mcp.git
cd chrome-extension-testing-mcp
npm install
npx playwright install chromium


______________________________________________________________________

## 使用Claude Desktop进行设置

将以下内容添加到您的Claude Desktop MCP配置文件中:

**macOS/Linux** — `~/.config/claude/claude_desktop_config.json`
**视窗** — `%APPDATA%\Claude\claude_desktop_config.json`

### 使用npx(推荐)```json
{
"mcpServers": {
"chrome-extension-tester": {
"command": "npx",
"args": ["chrome-extension-tester-mcp"]
}
}
}

使用本地克隆```json

{
"mcpServers": {
"chrome-extension-tester": {
"command": "node",
"args": ["/absolute/path/to/chrome-extension-testing-mcp/src/index.js"]
}
}
}


保存配置后重新启动Claude Desktop。

______________________________________________________________________

## 使用克劳德代码(npx)进行设置

添加到您的项目 `.mcp.json` 或用户级MCP配置:```json
{
"mcpServers": {
"chrome-extension-tester": {
"command": "npx",
"args": ["chrome-extension-tester-mcp"]
}
}
}

可用工具

工具 它做什么
load_extension 使用未打包的扩展启动Chromium;自动捕获扩展ID
interact_with_popup 打开弹出窗口,然后单击元素、键入文本或阅读内容
open_options_page 打开扩展的选项/设置页面并与之交互
inspect_dom 导航到URL、查询DOM选择器或计算任意JavaScript
get_service_worker_logs 读取缓冲的后台服务工作器控制台日志;可选择清除它们
take_screenshot 保存当前页面或弹出窗口的屏幕截图
run_assertion 断言某个元素存在、具有特定文本或JS表达式为真——返回PASS或FAIL
extension_storage 获取、设置、删除或清除密钥 chrome.storage.local, .sync,或 .session
monitor_network 在导航过程中捕获网络请求;检索或清除捕获的列表
check_badge 读取或断言扩展操作徽章文本和背景颜色
send_message_to_background 发送 chrome.runtime.sendMessage 从弹出式上下文中返回响应
test_context_menu 检查 contextMenus API可用性、模拟右键单击或直接调用菜单项处理程序
simulate_tab_events 打开、关闭、切换、列出或关闭所有浏览器选项卡
test_account_login 使用一次性电子邮件在任何网站上创建或重复使用测试帐户;凭据存储在 test-accounts.json 并在会话中重复使用

测试代理提示

服务器包括一个内置的MCP提示符,名为 extension-tester-agent --一个完全自动化的测试代理,用于验证所有已实现的更改并返回结构化报告。

参数

参数 必填 描述
extension_path yes 解压缩扩展文件夹的绝对路径
extension_description 是的 扩展的功能是什么——功能、UI、存储、后台行为
changes 是 本次会话中实施或更改的所有内容

它做什么

  1. 理解 扩展并从更改列表中导出一组测试
  2. 编写测试计划 --每个更改都映射到至少一个测试和正确的MCP工具
  3. 执行每个测试 --从不跳过,在失败时截图
  4. 报告 一个结构化的通过/失败表,其中包含任何失败的详细信息

如何调用

实施更改后,告诉Claude:```
Use the extension-tester-agent prompt with:
- extension_path: /path/to/my-extension
- extension_description: "A tab manager that saves sessions to chrome.storage.local and restores them via a popup"
- changes: "Added save button; save button writes open tabs to storage.local; badge shows count of saved tabs"


Claude将编写测试计划,执行每个测试,并返回完整的报告。

______________________________________________________________________

## 示例提示```
Load my extension from /Users/me/my-extension and open the popup
``````
Click the button with selector #save and take a screenshot
``````
Navigate to https://example.com and check if my content script injected a .banner element
``````
Read all keys from chrome.storage.local
``````
Set { "enabled": true } in chrome.storage.local and verify it was saved
``````
Navigate to https://example.com, capture all network requests, then show me any that were blocked
``````
Check the badge text — it should say "ON"
``````
Send the message { "type": "GET_STATUS" } to the background and show the response
``````
Open a tab to https://news.ycombinator.com, then another to https://github.com, then list all open tabs
``````
Right-click on https://example.com and trigger the context menu item with id "my-action"
``````
Create a test account on https://example.com/signup and save it as "my_test_account"
``````
Log in to https://example.com/login using the stored "my_test_account" credentials

项目结构```

chrome-extension-testing-mcp/
├── src/
│ ├── index.js # MCP server entry point
│ ├── state.js # Shared browser state and helpers
│ ├── prompts/
│ │ ├── index.js # Registers MCP prompts
│ │ └── extension-tester.js # extension-tester-agent prompt definition
│ └── tools/
│ ├── index.js # Aggregates all tool definitions and handlers
│ ├── load-extension.js
│ ├── popup.js
│ ├── dom.js
│ ├── logs.js
│ ├── screenshot.js
│ ├── assertion.js
│ ├── storage.js
│ ├── network.js
│ ├── options-page.js
│ ├── context-menu.js
│ ├── badge.js
│ ├── messaging.js
│ ├── tabs.js
│ └── account-login.js
├── package.json
└── README.md
```


备注

  • 浏览器在中启动 头部模式 (可见窗口),因此您可以实时查看测试运行
  • 屏幕截图默认为 ./screenshot.png 除非提供了自定义路径
  • 服务工作者日志从那时起就被缓冲 load_extension 被称为
  • 呼叫 load_extension 随时再次获取新的浏览器实例
  • Playwright无法自动化Chrome原生上下文菜单——使用 test_context_menu 随着 trigger_item 直接调用处理程序
  • 徽章和存储工具通过服务人员进行通信,因此扩展必须有一个后台服务人员(MV3)
  • test_account_login 使用 游击队邮件API 生成一次性电子邮件——不需要浏览器导航,也不需要机器人拦截。凭据存储在 test-accounts.json 在项目根目录下(将此添加到 .gitignore)
  • 使用 action: "auto" 为了 test_account_login 自动重用存储的凭据或创建新帐户(如果不存在)

许可证

麻省理工学院

常见问题

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

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

Chrome Extension Testing MCP 怎么在 Claude Desktop、Claude 里配置?

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

Chrome Extension Testing MCP 收费吗?

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

Chrome Extension Testing MCP 需要 API Key 吗?

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

Chrome Extension Testing MCP 支持哪些客户端?

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

Chrome Extension Testing MCP 能提供哪些能力?

资料显示约 14 个工具;能力标签包括 浏览器自动化、JavaScript、Claude、自然语言交互。具体工具清单以官方文档为准。

Chrome Extension Testing MCP 需要什么运行环境?

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

Chrome Extension Testing MCP 是本地还是远程?

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

热门专题

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

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