Amazon Q Cypress MCP

MCP开发工具

提供方 JMRMEDEV

开发工具 未标注 会话登录 社区 / 第三方

一个增强的Cypress端到端测试服务器,提供高级截图处理、干净的输出格式和自动文件管理功能。

一句话选型结论

按资料字段整理

Amazon Q Cypress MCP 属于开发工具类 MCP 服务器,传输方式未标注,会话登录,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

端到端测试JavaScript本地部署自动化测试截图管理测试框架开发工具

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

本地命令与脚本

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

接口联调与测试

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

选择建议

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

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

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

服务器档案

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

详细介绍

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

Cypress MCP服务器

一个增强的模型上下文协议(MCP)服务器,用于运行Cypress E2E测试,具有高级屏幕截图处理、干净的输出格式和自动文件管理功能。

特性

🖼️ 增强的屏幕截图管理

  • 仅视口捕捉:屏幕截图仅捕获渲染的应用程序内容,而不是Cypress runner UI
  • 成功截图:自动捕获失败和成功测试的屏幕截图
  • 干净命名:屏幕截图被复制到 /tmp 具有可预测的名称: screenshot-cypress--.png
  • 自动清理:执行后删除临时测试文件和原始屏幕截图
  • AI就绪输出:退货 /tmp 截图路径,便于人工智能处理

📊 清洁输出和记录

  • 结构化结果:返回全面的测试结果,包括成功、失败和执行摘要
  • 清理日志:删除ANSI转义码并格式化输出以提高可读性
  • 详细测试信息:提供测试持续时间、错误详细信息和执行统计信息
  • JSON解析:处理成功的JSON解析和回退到原始输出

🔧 高级配置

  • Webpack覆盖处理:可选处理webpack-dev服务器覆盖
  • 自定义浏览器支持:Chrome、Firefox、Edge、Electron支持
  • 灵活的测试输入:接受测试代码作为字符串或规范文件路径
  • 基本URL配置:用于测试的自动基本URL设置

安装```bash

cd ~/mcp-servers/cypress
npm install


## 用法

### 基本测试执行```javascript
// Run a simple test with screenshot capture
{
"testCode": `
describe('My Test', () => {
it('should work', () => {
cy.visit('/');
cy.get('h1').should('be.visible');
});
});
`,
"baseUrl": "http://localhost:3000",
"browser": "electron",
"headless": true
}

受保护路由测试```javascript

// Test protected routes with authentication
{
"testCode": `
describe('Protected Route Test', () => {
it('should access admin area', () => {
// Login first
cy.visit('/adminLogin');
cy.get('[data-testid="email-input"]').type('user@example.com');
cy.get('[data-testid="password-input"]').type('password');
cy.get('[data-testid="submit-button"]').click({force: true});

// Access protected route
cy.visit('/admin');
cy.url().should('include', '/admin');
cy.get('table').should('be.visible');
});
});
`,
"baseUrl": "http://localhost:3000",
"handleWebpackOverlay": true
}


## 响应格式

### 成功测试响应```json
{
"status": "completed",
"exitCode": 0,
"summary": {
"totalTests": 1,
"passed": 1,
"failed": 0,
"pending": 0,
"skipped": 0,
"durationMs": 5000
},
"successes": [
{
"spec": "temp-abc123.cy.js",
"test": "My Test > should work",
"duration": 5000
}
],
"failures": [],
"screenshots": [
"/tmp/screenshot-cypress-1703123456789-abc12345.png"
],
"logs": {
"stdout": "Clean test execution output...",
"stderr": ""
}
}

测试响应失败```json

{
"status": "failed",
"exitCode": 1,
"summary": {
"totalTests": 1,
"passed": 0,
"failed": 1,
"pending": 0,
"skipped": 0,
"durationMs": 3000
},
"successes": [],
"failures": [
{
"spec": "temp-abc123.cy.js",
"test": "My Test > should fail",
"error": "AssertionError: expected element to be visible..."
}
],
"screenshots": [
"/tmp/screenshot-cypress-1703123456789-def67890.png"
],
"logs": {
"stdout": "Test execution output...",
"stderr": "Error details..."
}
}


## 参数

|参数|类型|默认值|说明|
|-----------|------|---------|-------------|
| `testCode` |string |-|Cypress测试代码为字符串(替代规范文件)|
| `spec` |string |-|现有规范文件的路径(例如。, `cypress/e2e/login.cy.js`) |
| `browser` |字符串| `chrome` |要使用的浏览器(`chrome`, `firefox`, `edge`, `electron`) |
| `headless` |布尔值| `true` |在无头模式下运行|
| `baseUrl` |string |-|测试的基本URL(例如。, `http://localhost:3000`) |
| `handleWebpackOverlay` |布尔值| `false` |处理webpack-dev服务器覆盖问题|
| `config` |对象| `{}` |其他Cypress配置选项|

## 屏幕截图配置

服务器会自动为Cypress配置最佳屏幕截图设置:```javascript
// Applied automatically to all tests
Cypress.Screenshot.defaults({
capture: 'viewport',           // Only capture app content, not runner UI
disableTimersAndAnimations: true,  // Consistent screenshots
blackout: [],                 // No elements blacked out
overwrite: true              // Prevent duplicate files
});

// Success screenshots added automatically
afterEach(function() {
if (this.currentTest.state === 'passed') {
cy.screenshot('test-success', {
capture: 'viewport',
overwrite: true
});
}
});

文件管理

自动清理过程

  1. 测试期间:Cypress在中生成屏幕截图 cypress/screenshots/
  2. 测试后:服务器将屏幕截图复制到 /tmp/ 名字干净
  3. 清理:删除临时 .cy.js 文件和原件 .png 文件
  4. 返回:提供 /tmp 响应中的截图路径

截图命名约定

  • 格式: screenshot-cypress--.png
  • 位置: /tmp/ 目录
  • 示例: /tmp/screenshot-cypress-1703123456789-a1b2c3d4.png

Webpack覆盖处理

当 handleWebpackOverlay: true 设置后,服务器会自动添加:```javascript
// Auto-dismisses webpack dev server overlays
Cypress.Commands.add('dismissWebpackOverlay', () => {
cy.get('iframe[id*="webpack-dev-server-client-overlay"]', { timeout: 1000 })
.should('exist')
.then(($iframe) => {
const iframeDoc = $iframe.contents();
const closeButton = iframeDoc.find('button, [role="button"], .close');
if (closeButton.length) {
closeButton.click();
}
})
.catch(() => {
// Overlay not present, continue
});
});

beforeEach(() => {
cy.dismissWebpackOverlay();
});


## 最佳实践

### 1.受保护路由测试

在访问受保护的路由之前,请务必登录:```javascript
// Login first
cy.visit('/login');
cy.get('[data-testid="email"]').type('user@example.com');
cy.get('[data-testid="password"]').type('password');
cy.get('[data-testid="submit"]').click({force: true});

// Verify login success
cy.url({ timeout: 15000 }).should('include', '/dashboard');

// Then access protected route
cy.visit('/protected-route');

2.等待内容

留出时间加载动态内容:```javascript
cy.get('table', { timeout: 15000 }).should('be.visible');
cy.wait(2000); // Allow content to fully render before screenshot


### 3.使用数据测试ID

使用 `data-testid` 可靠元素选择的属性:```javascript
cy.get('[data-testid="submit-button"]').click({force: true});

故障排除

未生成屏幕截图

  • 确保测试实际运行(检查日志)
  • 验证 /tmp 目录权限
  • 检查Cypress是否配置正确

测试失败

  • 查看 failures 数组响应
  • 检查 logs.stderr 有关详细的错误信息
  • 验证基本URL是否可访问

Webpack覆盖问题

  • 集 handleWebpackOverlay: true
  • 确保开发服务器正在运行
  • 检查日志中的控制台错误

依赖项

  • @modelcontextprotocol/sdk:MCP服务器框架
  • glob:用于屏幕截图清理的文件模式匹配
  • cypress:E2E测试框架(对等依赖)

发展

要修改服务器,请执行以下操作:

  1. 编辑 server.js
  2. 测试语法: node -c server.js
  3. 重新启动MCP客户端以获取更改

许可证

麻省理工学院

常见问题

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

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Amazon Q Cypress MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Amazon Q Cypress MCP 收费吗?

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

Amazon Q Cypress MCP 需要 API Key 吗?

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

Amazon Q Cypress MCP 能提供哪些能力?

资料显示能力标签包括 测试框架、JavaScript、开发工具。具体工具清单以官方文档为准。

热门专题

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

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