MCP Apps Testing

MCP浏览器工具

提供方 aviveldan · 包名 playwright

浏览器工具 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeVS Code
查看接入方式

mcp-apps-testing是一个用于测试MCP Apps外部UI的框架,提供单元测试、端到端浏览器测试和真实VS Code集成测试的工具。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

测试框架TypeScript本地部署UI测试JSON-RPCPlaywrightVSCode集成

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx playwright install chromium

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

抓取结构化数据

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

关键流程回归

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

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

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

服务器档案

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

详细介绍

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

mcp应用程序测试

mcp-apps测试是一个用于mcp应用程序外部UI(ext应用程序)的测试框架。它提供了用于测试MCP应用程序UI渲染、iframe沙盒行为和postMessage协议通信的工具。该框架包括用于单元测试的模拟主机环境、用于E2E浏览器测试的符合规范的参考实现,以及用于生产环境测试的真实VS Code集成。

> 关于主机支持的说明:该框架提供 模拟主机配置文件 (VSCode,类似克劳德,通用)用于通过以下方式进行单元测试 MockMCPHost。这些不是与真正的Claude Desktop或其他IDE的连接。对于真实环境测试,请使用 VSCodeHost (Playwright Electron提供的真实VS代码)或 ReferenceHost (符合规范的浏览器实现)。

目录

  • 为什么要测试mcp应用程序?
  • 快速开始
  • 安装
  • 主要特点
  • 建筑
  • 例子
  • 文档
  • 命令
  • 出版
  • 贡献
  • 许可证

为什么要测试mcp应用程序?

构建MCP应用程序?您需要测试的不仅仅是协议,还需要验证UI渲染、沙盒行为和主机通信。 该框架提供了三种测试方法:使用模拟的单元测试、使用参考实现的基于浏览器的E2E测试和真实的VS代码集成测试。

零配置单元测试```typescript
const host = new MockMCPHost({ hostProfile: 'VSCode' });
await host.callTool('greet', { name: 'World' });


**是什么让它独一无二**

- **模拟主机配置文件**:使用模拟主机配置文件(VSCode、克劳德式、通用)进行单元测试,提供不同的功能和主题
- **完全控制**:对每条JSON-RPC消息进行模拟、拦截和断言
- **参考实现**:使用符合规范的MCP ext应用程序主机(ReferenceHost)进行基于浏览器的E2E测试
- **真实VS代码E2E**:使用Playwright Electron(VSCodeHost)在真实的VS Code实例中通过Copilot Chat测试MCP工具
- **流利的API**:具有自动重试和智能默认值的人类可读测试代码

## 快速开始

### 安装

安装该包及其对等依赖关系:```bash
npm install mcp-apps-testing @playwright/test --save-dev
npx playwright install chromium

写你的第一个测试```typescript
import { test, expect } from '@playwright/test';
import { MockMCPHost } from 'mcp-apps-testing';

test('MCP app responds to tool calls', async () => {
const host = new MockMCPHost({ hostProfile: 'VSCode' });

// Mock the tool response
host.getInterceptor().mockResponse('tools/call', (req) => ({
jsonrpc: '2.0',
id: req.id,
result: { content: [{ type: 'text', text: 'Hello, World!' }] }
}));

// Call the tool with fluent API
const response = await host.callTool('greet', { name: 'World' });
expect(response.result.content[0].text).toBe('Hello, World!');

await host.cleanup();
});


**运行测试**: `npm test`

## 主要特点

### 用于单元测试的模拟主机配置文件

使用提供不同功能和主题的模拟主机环境测试您的MCP应用程序:```typescript
new MockMCPHost({ hostProfile: 'VSCode' })   // Simulates VS Code-like environment
new MockMCPHost({ hostProfile: 'Claude' })   // Simulates Claude-like environment
new MockMCPHost({ hostProfile: 'Generic' })  // Generic MCP host simulation

注:这些是 单元测试的模拟剖面,而不是与真实主机的连接。对于真实的VS代码测试,请使用 VSCodeHost.

完成消息控制

模拟、拦截并记录每次JSON-RPC交互:```typescript
// Mock responses
host.getInterceptor().mockResponse('tools/call', yourHandler);

// Record and assert
const requests = host.getInterceptor().getRecordedRequests();
expect(requests[0].method).toBe('initialize');


### 一起测试UI+协议

在同一测试中验证视觉渲染和协议行为:```typescript
// Test UI rendering in browser with ReferenceHost
const host = await ReferenceHost.launch(page, 'your-mcp-app.html');
const frame = host.getAppFrame();
await expect(frame.locator('h1')).toBeVisible();

// Test protocol interaction
await host.sendMessage({ jsonrpc: '2.0', id: 1, result: { greeting: 'Hello' } });

建筑```mermaid

graph TD
App[Your MCP Application
HTML + JavaScript]
PW[Playwright
• Browser Automation
• UI Testing
• Screenshots]

App -->|JSON-RPC 2.0| TI[TransportInterceptor
Mock & Record Messages
Request/Response Interception]

TI -->|Used by| Mock[MockMCPHost
Simulated Host for Unit Testing
Auto-respond to Protocol Messages
Fluent DSL Methods]

PW -->|Controls| Mock
Mock -->|Uses| Profiles[Host Profiles
• VSCode simulation
• Claude-like simulation
• Generic simulation]

App -->|postMessage| Ref[ReferenceHost
Spec-Compliant Browser Host
Real iframe + postMessage
E2E Testing]

PW -->|Controls| Ref

App -->|Real MCP Protocol| VSC[VSCodeHost
Real VS Code Instance
100% Production Environment
Copilot Chat Integration]

PW -->|Electron| VSC

Mock --> Results[Test Results & Assertions
Message Recording • Protocol Logging • Traces]
Ref --> Results
VSC --> Results

style App fill:#e0e7ff,stroke:#6366f1,color:#1e293b
style TI fill:#6366f1,stroke:#4338ca,color:#fff
style Mock fill:#8b5cf6,stroke:#7c3aed,color:#fff
style Ref fill:#8b5cf6,stroke:#7c3aed,color:#fff
style VSC fill:#10b981,stroke:#059669,color:#fff
style Profiles fill:#e0e7ff,stroke:#6366f1,color:#1e293b
style PW fill:#e0e7ff,stroke:#6366f1,color:#1e293b
style Results fill:#e0e7ff,stroke:#6366f1,color:#1e293b


**核心组件**

- **模拟MCPHost**:用于单元测试的模拟MCP主机,可自动响应常见协议消息。使用主机配置文件(VSCode、类似Claude、Generic)测试不同的功能和主题。
- **运输拦截器**:模拟和记录JSON-RPC消息以进行测试和断言
- **主机配置文件**:具有单元测试功能和主题的预配置模拟环境(VSCode、克劳德式、通用)
- **引用主机**:符合规范的基于浏览器的MCP-ext应用程序主机,用于E2E测试。在具有iframe沙盒的真实浏览器中实现postMessage协议。
- **VSCodeHost**:通过Playwright Electron进行Real VS Code E2E测试。启动VS Code,与Copilot Chat交互,并在100%生产环境中测试MCP工具。

## 例子

看 示例/ 完整工作示例目录:

- **世界规格**:通过主题切换和工具调用进行完整的UI测试
- **基本技术规范**:使用消息模拟进行以协议为中心的测试
- **vscode-e2e.spec.ts**:VS Code E2E测试——通过Copilot聊天进行完整的MCP工具调用

## 文档

- 入门指南 -详细的设置和第一步
- API 参考 -完整的API文件
- VS代码E2E测试 -在真实的VS代码中测试MCP ext应用程序
- 示例应用程序 -MCP应用示例

## 命令```bash
npm test              # Run all tests
npm run test:ui       # Run with Playwright UI
npm run build         # Build the framework
npm run dev           # Development mode with watch

出版

此包通过GitHub Actions自动发布到npm,并具有完全的CI/CD自动化功能。

CI/CD工作流程

持续集成(ci.yml)

自动运行于:

  • 将请求拉到 main
  • 推到 main 分支

在Node.js版本18、20和22上测试该包:

  • Lints TypeScript代码
  • 构建包
  • 使用Playwright运行所有测试
  • 将测试结果作为工件上传

自动发布(Release.yml)

通过GitHub操作界面手动触发:

  1. 首选 行动 → 发布 → 运行工作流
  2. 选择版本凹凸类型:
    - patch -错误修复(0.1.1→0.1.2)
    - minor -新功能(0.1.1→0.2.0)
    - major -重大变化(0.1.1→1.0.0)
  3. 工作流会自动执行以下操作:
    - 运行所有测试和linting
    - 将版本插入 package.json
    - 创建git标签
    - 将更改和标签推送到GitHub
    - 创建GitHub版本
    - 使用具有出处的OIDC可信发布发布发布到npm

传统发布(Publish.yml)

保持向后兼容性。当手动创建GitHub版本时,发布到npm。

手动出版(如需要)

要手动发布,请执行以下操作:bash npm run build npm test npm publish

这 prepublishOnly 该脚本确保在发布之前创建干净的构建。

贡献

该框架专为专业MCP UI应用程序测试而设计。贡献应保持模块化架构,并专注于核心测试能力。

许可证

麻省理工学院


内置: TypeScript•剧作家

了解更多: 模型上下文协议 • 剧作家

常见问题

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

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

MCP Apps Testing 怎么在 Claude Desktop、Claude、VS Code 里配置?

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

MCP Apps Testing 收费吗?

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

MCP Apps Testing 需要 API Key 吗?

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

MCP Apps Testing 支持哪些客户端?

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

MCP Apps Testing 能提供哪些能力?

资料显示能力标签包括 测试框架、浏览器自动化、TypeScript、Claude。具体工具清单以官方文档为准。

MCP Apps Testing 需要什么运行环境?

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

MCP Apps Testing 是本地还是远程?

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

热门专题

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

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