1 v0.1.2 更新于 2026-10-13
cypress-mcp MCP Server
Shows an AI assistant the last cypress run: command log, errors, screenshots, DOM of failed tests.
适用客户端
本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端
安装配置
本地运行(npm)
{
"mcpServers": {
"cypress-mcp": {
"command": "npx",
"args": [
"-y",
"@miroslavmyrha/cypress-mcp"
]
}
}
}将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。
提供的工具 接入后 Agent 可调用这 7 个工具
list_specs
列出所有 Cypress 测试规格文件,支持可选的 glob 模式过滤。
read_spec
按相对路径读取规格文件的内容。
get_config
读取 Cypress 配置文件内容,并对疑似密钥的值进行脱敏。
get_last_run
获取最近一次测试运行的结果,包括状态、错误、命令日志和 DOM 快照。
get_screenshot
获取最近一次运行中的截图,返回图片本身及路径和大小元数据。
query_dom
使用 CSS 选择器查询失败测试的 DOM 快照。
run_spec
运行单个 Cypress 规格文件并等待完成,返回退出码和摘要。