Cypress Cloud MCP

✨ Cypress AI Toolkit

由 Cypress 团队打造的开源 Cypress AI 技能。适用于 Claude、Cursor、GitHub Copilot 等。

你的 AI 工具能力很强，只是它对 Cypress 的了解不如你。这个工具包通过由 Cypress 团队打造的技能、上下文和指导来解决这一问题。

Cypress 还在 App 和 Cypress Cloud 中提供 AI 功能，例如 cy.prompt()、Studio AI、Cloud MCP、Test Intent 和 Error Summaries，以及 UI Coverage 测试生成。请在 Cypress AI 文档中了解详情。

要解决的问题

AI 工具可以使用 Cypress，但难以始终如一地正确应用它。

如果没有指导，AI 工具就会退回到通用模式——没有充分利用 Cypress API、错误地应用选择器，也会跳过经验丰富的 Cypress 开发者逐渐熟记的最佳实践。结果虽然在技术上可以运行，却并不可靠。

Cypress AI Toolkit 为你的 AI 工具提供所需的 Cypress 专属上下文，帮助它们生成你真正可以基于其继续构建的内容，并在整个团队和工作流中保持一致。

工具包包含的内容

Model Context Protocol (MCP)

Cypress Cloud MCP 服务可将你的 AI 编码助手直接连接到 Cypress Cloud，让它们访问有关应用健康状况和稳定性的数据。

有关 Cypress Cloud MCP 的更多信息，请参阅此处。

如果有适用于你的 Agent 的一流安装程序，请使用它：

工具	适用场景
Cypress Claude Connector	适用于 Claude Desktop 应用用户
Cypress Cursor Plugin	适用于 Cursor 用户
Cypress VS Code Extension (Cypress-io.vscode-cypress-cloud-mcp)	适用于 VS Code 和 GitHub Copilot 用户

注意： MCP 连接默认使用 OAuth。如果你想使用个人访问令牌 (PAT)，则需要调整 Agent 的 .mcp.json 文件。

Skills

Skills 是 AI 工具加载的指令集，可在生成或审查测试代码时运用 Cypress 专属知识。它们弥补了 AI 在训练期间学到的内容与当前编写良好的 Cypress 测试之间的差距。

目前提供五种 Skills：

• cypress-author — 改进 AI 工具创建、更新和修复 Cypress 测试的方式。适用于编写新测试或修复损坏的测试。
• cypress-explain — 帮助你理解、描述和评审现有测试。适用于审查测试套件、帮助新团队成员熟悉项目，或在重写脆弱测试前进行调查。
• cypress-docs - 帮助你的 Agent 更高效、可靠地研究和检索有关 Cypress 的信息。
• cypress-tap — 驱动正在运行的 Cypress open-mode 会话来运行规格、检查结果、诊断失败，并在无需 GUI 交互的情况下查询被测应用。
• cypress-cloud-cli — 通过 Cypress Cloud CLI 调查 Cypress Cloud 运行记录、测试、失败、截图和 Test Replay 数据。

Skills 适用于任何支持自定义指令的 AI 工具，包括 Claude、Cursor 和 GitHub Copilot。

请参阅 skills 文档，了解安装说明、提示词示例和故障排除方法。

即将推出

我们正在打造更全面的工具包。

社区将帮助确定优先事项。如果你已经在使用 AI 驱动的 Cypress 工作流，我们想了解你的做法。提交 issue 或 提交 PR。

入门

Plugin

Cypress AI 工具包以 plugin 的形式发布，可安装到你的 Agent 中。这是安装和配置此软件包中各种功能最简单的方式，也支持自动更新。

Note：我们在 Cursor 官方 plugin 市场中的上架申请目前仍在审核中。上架后，我们会更新此 README。在此之前，你可以克隆此代码仓库，并将其作为本地 plugin 安装到所选 Agent 中。

Claude

此 plugin 已发布在 Claude Community Plugins 市场中——请参阅此处的说明，了解如何配置 Claude 实例以使用该市场。配置好市场后，你可以搜索 cypress plugin。

手动安装

如果你使用其他 Agent，或希望按需选择，可以从此代码仓库中挑选所需部分。

1. 使用命令行工具安装 Skills

• skills 软件包：

  npx skills add cypress-io/ai-toolkit
  

• GitHub CLI：

  gh skill install cypress-io/ai-toolkit
  

2. 按照平常的方式向 AI 工具输入提示词。相关 Skills 会在适用时自动启用；你也可以使用斜杠命令（例如 /cypress-author）直接调用某个 Skill。

   关于手动安装、提示词示例等更多信息，请参阅 skills 文档或 Cypress AI Skills 文档。

3. 使用适用于你的 Agent 的安装程序连接 Cypress Cloud MCP（请参阅上文的 MCP 表格）。你也可以从 mcp/ 复制配置，或参阅此处的配置说明。

适用对象

此工具包面向使用 AI 编码工具、希望获得一致且可靠的输出（而不只是能运行的代码）的 Cypress 开发者。

如果你希望 AI 工具能够：

• 遵循 Cypress 惯例和最佳实践，无需每次都提醒
• 生成可重复使用、可持续扩展的工作流，而不只是一次性的补全
• 在整个团队中保持一致的行为，不受提示者影响

那么这款工具包就适合你。

使用它不需要具备 AI 专业知识。你需要的是 Cypress 和 AI 编码工具。

贡献

欢迎各种形式的贡献：新增技能、改进现有技能、提交错误报告和分享想法。

如果你构建了能让 AI 工具更了解 Cypress 的内容，这里就是分享的好地方。

阅读贡献指南以开始参与。

发布

PR 检查

对技能的任何更改都应在 SKILL.md 文件的 version 前置元数据字段中进行相应的 semver 版本更新。

对工具包中任何功能性内容的更改（例如技能和 mcp，不包括文档）都应更新 .cursor-plugin 和 .claude-plugin 下的 version 元数据，以便插件市场能够发现并据此更新。

PR 合并后的操作

合并包含技能更改的更新后，请从 main 分支运行 gh skill publish。使用 --dry-run 预览更改。版本应与上面的插件版本一致——这可能与各个技能的版本不一致，但应视为“软件包”版本。

许可证

MIT