@assert-click/mcp

Assert용 MCP 서버 — AI 코딩 에이전트가 채팅창을 벗어나지 않고도 E2E 테스트를 생성, 실행 및 검사할 수 있게 해줍니다.

사용자 흐름을 평문 영어로 설명하세요. Assert는 Playwright 테스트를 생성하고, 실제 브라우저에서 실행하며, 단계별 결과와 실패 스크린샷을 반환합니다. 이 모든 과정은 Cursor, Claude, Windsurf 또는 MCP 호환 에이전트의 단일 도구 호출로 이루어집니다.

**assert.click에서 무료로 가입**하여 이 패키지를 사용하기 전에 API 키와 프로젝트 ID를 받으세요.

에이전트가 할 수 있는 작업

생성(Generate) — 흐름을 설명하고, 저장 및 실행 준비가 된 마크다운 시나리오를 받습니다.
실행(Run) — 저장된 시나리오나 임시 마크다운을 실제 Chromium 브라우저에서 실행합니다.
검사(Inspect) — 단계별 성공/실패 여부, 오류 메시지, 실패 스크린샷 URL을 가져옵니다.
목록(List) — 프로젝트에 저장된 시나리오를 탐색합니다.

요구 사항

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`

평문 영어 설명으로부터 마크다운 시나리오를 생성합니다.

입력:

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`

저장된 시나리오나 임시 마크다운을 실제 브라우저에서 실행합니다.

입력:

scenario_id?: string
markdown?: string
project_id?: string
request_id?: string

scenario_id 또는 markdown 중 하나는 반드시 제공되어야 합니다.

반환:

{
  "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

Assert