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 は、チームやワークフロー全体で一貫して、実際に活用できる出力を生成するために必要な Cypress 固有のコンテキストを AI ツールに提供します。

ツールキットの内容

Model Context Protocol (MCP)

Cypress Cloud MCP サーバーは、AI コーディングアシスタントを Cypress Cloud に直接接続し、アプリケーションの健全性と安定性に関するデータにアクセスできるようにします。

Cypress Cloud MCP の詳細については、こちらをご覧ください。

エージェント用の専用インストーラーがある場合は、それを使用してください。

ツール	使用する場面
Cypress Claude Connector	Claude Desktop アプリのユーザー向け
Cypress Cursor Plugin	Cursor ユーザー向け
Cypress VS Code Extension (Cypress-io.vscode-cypress-cloud-mcp)	VS Code と GitHub Copilot のユーザー向け

Note: MCP 接続では、デフォルトで OAuth が使用されます。Personal Access Token（PAT）を使用する場合は、エージェントの .mcp.json ファイルを調整する必要があります。

スキル

スキルは、テストコードの生成やレビュー時に、AI ツールが Cypress 固有の知識を活用できるように読み込む指示セットです。AI がトレーニング中に学習した内容と、現在の適切に記述された Cypress テストとのギャップを埋めます。

現在、5 つのスキルを利用できます。

• cypress-author — AI ツールによる Cypress テストの作成、更新、修正を改善します。新しいテストを作成するときや、壊れたテストを修正するときに使用します。
• cypress-explain — 既存のテストの理解、説明、評価を支援します。テストスイートの監査、新しいチームメンバーのオンボーディング、書き直す前の不安定なテストの調査に使用します。
• cypress-docs - エージェントが Cypress に関する情報をより効率的かつ確実に調査、取得できるようにします。
• cypress-tap — 実行中の Cypress オープンモードセッションを操作し、スペックの実行、結果の確認、失敗の診断、GUI を使わずにテスト対象アプリの照会を行います。
• cypress-cloud-cli — Cypress Cloud CLI を通じて、Cypress Cloud の実行、テスト、失敗、スクリーンショット、Test Replay データを調査します。

スキルは、Claude、Cursor、GitHub Copilot など、カスタム指示を受け付けるあらゆる AI ツールで利用できます。

インストール手順、プロンプトの例、トラブルシューティングについては、スキルのドキュメントをご覧ください。

今後の予定

より幅広いツールキットの構築を進めています。

優先する項目はコミュニティとともに決めていきます。AI を活用した Cypress ワークフローをすでに実現している方は、ぜひその方法をお聞かせください。Issue を作成するか、PR を作成してください。

はじめに

プラグイン

Cypress AI toolkit は、エージェントにインストールするプラグインとして公開されています。このパッケージのさまざまな機能をインストール、設定する最も簡単な方法であり、自動更新機能も利用できます。

注：Cursor の公式プラグインマーケットプレイスへの登録は現在保留中です。利用可能になり次第、この README を更新します。それまでは、このリポジトリをクローンし、お好みのエージェントにローカルプラグインとしてインストールできます。

Claude

このプラグインは Claude Community Plugins マーケットプレイスで公開されています。このマーケットプレイスを使用するための Claude インスタンスの設定方法については、こちらの手順をご覧ください。マーケットプレイスを設定したら、cypress プラグインを検索できます。

手動インストール

別のエージェントを使用している場合や、必要なものだけを選びたい場合は、このリポジトリから必要な部分を選んで使用できます。

1. コマンドラインツールを使ってスキルをインストールします。

• skills パッケージ：

  npx skills add cypress-io/ai-toolkit
  

• GitHub CLI：

  gh skill install cypress-io/ai-toolkit
  

2. 通常どおり AI ツールにプロンプトを入力します。スキルは関連する場面で自動的に有効になります。または、スラッシュコマンド（例：/cypress-author）で直接呼び出すこともできます。

   手動インストール、プロンプトの例などについては、スキルのドキュメントまたはCypress AI Skills のドキュメントをご覧ください。

3. エージェント用のインストーラーで 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