@assert-click/mcp

Assert 用のMCPサーバー — AIコーディングエージェントがチャットを離れることなく、E2Eテストの生成、実行、検証を行えるようにします。

ユーザーフローを平易な英語で記述してください。AssertはPlaywrightテストを生成し、実際のブラウザで実行し、ステップごとの結果と失敗時のスクリーンショットを返します。これらすべてをCursor、Claude、Windsurf、またはMCP互換エージェントの単一のツール呼び出しで行えます。

assert.clickで無料登録 して、このパッケージを使用する前にAPIキーとプロジェクトIDを取得してください。

エージェントができること

• 生成 — フローを記述し、保存して実行可能なMarkdownシナリオを取得します

• 実行 — 保存されたシナリオまたはアドホックなMarkdownを実際のChromiumブラウザで実行します

• 検証 — ステップごとの成功/失敗、エラーメッセージ、失敗時のスクリーンショットURLを取得します

• 一覧表示 — プロジェクトの保存済みシナリオを閲覧します

要件

• Node.js >=18.17

• プロジェクトスコープのAssertキー — assert.click で取得してください

セットアップ

1. リポジトリに assert.config.json を作成します:

{
  "projectApiKey": "assert_project_key_here",
  "projectId": "project_123"
}

2. エージェント設定にMCPサーバーを追加します:

{
  "mcpServers": {
    "assert": {
      "command": "npx",
      "args": ["-y", "@assert-click/mcp"],
      "env": {
        "ASSERT_CONFIG": "/absolute/path/to/assert.config.json"
      }
    }
  }
}

以上です。これでエージェントは4つのAssertツールすべてにアクセスできるようになります。

環境変数

• ASSERT_API_KEY: APIキー (assert.config.json に保存する代わりに使用)

• ASSERT_PROJECT_ID: オプションのデフォルトプロジェクトID

• ASSERT_CONFIG: 設定ファイルまたはディレクトリへのオプションのパス

設定ファイル

MCPサーバーは、現在のディレクトリから上位に向かって以下のファイルを探します:

• assert.config.json

• assert.config.local.json

assert.config.local.json は assert.config.json の上にマージされます。

キーをコミットする代わりに環境変数ベースのシークレットを好む場合:

{
  "projectApiKeyEnv": "ASSERT_API_KEY",
  "projectId": "project_123"
}

ツール

assert_generate

平易な英語の説明からMarkdownシナリオを生成します。

入力:

• description: string — ユーザーができるべきこと

• url: string — 開始URL

• project_id?: string

• save?: boolean — プロジェクトに保存するかどうか (デフォルト: true)

戻り値:

{
  "scenario_id": "scenario_123",
  "markdown": "URL: https://example.com/login\nSCENARIO: Login\nPROCESS:\n  - Fill \"email\" with \"user@example.com\"\nEXPECT: Dashboard",
  "saved": true
}

assert_run

保存されたシナリオまたはアドホックなMarkdownを実際のブラウザで実行します。

入力:

• scenario_id?: string

• markdown?: string

• project_id?: string

• request_id?: string

scenario_id または markdown のいずれか1つを必ず指定する必要があります。

戻り値:

{
  "run_id": "run_123",
  "status": "queued",
  "estimated_duration_seconds": null
}

assert_status

実行のステップごとの結果を取得します。

入力:

• run_id: string

戻り値:

{
  "run_id": "run_123",
  "status": "passed",
  "duration_ms": 4200,
  "steps": [
    {
      "description": "Fill email",
      "status": "passed",
      "error": null,
      "screenshot_url": null
    }
  ],
  "failure_summary": null,
  "full_log_url": null
}

assert_list

プロジェクトの保存済みシナリオを一覧表示します。

入力:

• project_id?: string

• cursor?: string

• limit?: number

戻り値:

{
  "scenarios": [
    {
      "id": "scenario_123",
      "name": "Login flow",
      "project_id": "project_123",
      "last_run_status": "passed",
      "last_run_at": "2026-03-31T10:00:00.000Z",
      "url": "https://example.com/login"
    }
  ],
  "next_cursor": null
}

エラー

エラーは構造化されたJSONとして返されます:

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The ASSERT_API_KEY is invalid or missing.",
    "field": null
  }
}

一般的なコード:

• INVALID_API_KEY

• SCENARIO_NOT_FOUND

• RUN_NOT_FOUND

• VALIDATION_ERROR

• UPSTREAM_ERROR

ライセンス

MIT