PlaywrightGen MCP server
2026년 11월 14일 커밋AI 에이전트가 승인된 요구사항을 읽고, Playwright 자동화 코드를 생성하며, 에디터 내에서 테스트 증거를 관리할 수 있도록 지원합니다.
다른 이름 hmamut39/playwrightgen
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- —
PlaywrightGen MCP란?
AI 에이전트가 승인된 요구사항을 읽고, Playwright 자동화 코드를 생성하며, 에디터 내에서 테스트 증거를 관리할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
PlaywrightGen MCP server 정보
PlaywrightGen은 AI 에이전트가 브라우저 자동화의 전체 라이프사이클을 관리할 수 있는 구조적인 방법을 제공합니다. 요구사항, 테스트 케이스, 실제 코드를 연결하여 감사 또는 릴리스 결정을 위한 검증 가능한 증거 체인을 생성합니다. Claude Code, Cursor 또는 Copilot과 같은 AI 클라이언트를 사용하는 개발자는 무엇을 테스트할지 추측하는 대신, 이 server를 통해 승인된 의도를 읽어올 수 있습니다. 이 server에는 에이전트가 요구사항을 처리하고, 테스트 케이스를 관리하며, 자동화 초안을 제안하고, 최근 실패 사례를 분석할 수 있는 16개의 도구가 포함되어 있습니다.
이 server가 작동하려면 PostgreSQL 데이터베이스, OpenAI API 키, Clerk 인증을 포함한 여러 설정이 필요합니다. 또한 원격 브라우저 실행을 위해 Browserless를 사용하며, AI 허용량을 관리하기 위해 Upstash Redis를 활용합니다. GitHub와 통합하면 이슈로부터 요구사항 초안을 작성하고 승인된 테스트 코드가 포함된 pull request를 생성할 수 있습니다. 시스템은 엄격한 직무 분리를 강제하여, 에이전트가 코드를 제안할 수는 있지만 자신이 생성한 기록을 승인하거나 삭제할 수는 없도록 보장합니다.
활용 사례
- 1요구사항 기반 자동화 생성AI 에이전트가 승인된 요구사항을 읽고 검토를 위한 테스트 케이스 초안을 제안할 수 있습니다.
- 2라이브 페이지 기반 테스트 검증시스템이 공개 URL을 읽고 실제 접근성 트리(accessibility tree)를 기반으로 Playwright 테스트를 작성할 수 있습니다.
- 3GitHub 이슈 기반 문서화 자동화이 server는 GitHub 통합을 사용하여 티켓을 공식 요구사항으로 변환할 수 있습니다.
- 4감사 추적 유지개발자는 CI 테스트 결과를 특정 승인된 테스트 버전과 연결할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
PlaywrightGen MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 PlaywrightGen MCP 설치
$ claude mcp add --transport http playwrightgen https://playwrightgen.com/api/mcpCursor에 PlaywrightGen MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"playwrightgen": {
"url": "https://playwrightgen.com/api/mcp"
}
}
}VS Code에 PlaywrightGen MCP 설치
.vscode/mcp.json
{
"servers": {
"playwrightgen": {
"type": "http",
"url": "https://playwrightgen.com/api/mcp"
}
}
}VS Code CLI에 PlaywrightGen MCP 설치
$ code --add-mcp '{"name":"playwrightgen","type":"http","url":"https://playwrightgen.com/api/mcp"}'Codex에 PlaywrightGen MCP 설치
$ codex mcp add playwrightgen --url https://playwrightgen.com/api/mcpCodex config.toml에 PlaywrightGen MCP 설치
~/.codex/config.toml
[mcp_servers.playwrightgen] url = "https://playwrightgen.com/api/mcp"
Gemini CLI에 PlaywrightGen MCP 설치
$ gemini mcp add -s user --transport http playwrightgen https://playwrightgen.com/api/mcpGemini settings.json에 PlaywrightGen MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"playwrightgen": {
"url": "https://playwrightgen.com/api/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능hmamut39/playwrightgen is public and reachablegithub.com/hmamut39/playwrightgen ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-14github.com/hmamut39/playwrightgen ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기PlaywrightGen
Playwright tests written from your real page, run until they pass, and kept as evidence a person approved.
Live at playwrightgen.com.
Writing a Playwright test is no longer the hard part — every editor has an assistant that will do it. What none of them keep is the thing an audit, a release decision or a customer actually asks for: which behaviour was agreed, by whom, at which version, and what the last run proved. That record is what this product is.
How it works
Two ways in, one chain.
The free tools need no account. Say what to test, paste a public URL, and PlaywrightGen reads the page, writes a test from its real accessibility tree, runs it in a remote browser, and fixes the failing step until it passes. You get working code and the run that proves it, signed so the evidence survives if you later bring it into a workspace. Nothing durable is claimed until you do.
The workspace turns that into a record:
- A Requirement is drafted, reviewed and approved. Approving writes an immutable version.
- Test Cases carry objective, steps and expected results, are approved the same way, and link to the Requirements they verify.
- Automation is generated from an approved Test Case version, validated against deterministic rules, proven on the live page, and then approved by a person — never by the generator and never by an agent.
- Run evidence arrives from your own CI. Your tests run on your runners,
against your environment, with your secrets; only a bounded summary of
results is sent. A
[pwg:...]marker in the test title is what ties a result to the approved version it is evidence for. - A proof link shares the result outside the team: a signed URL anybody can open, with an acceptance signature and a downloadable file they can keep.
Every claim on that chain names its source. A requirement with no passing test says so; a run that was skipped says it proved nothing; a report that was bounded says how much it did not cover.
What holds it honest
- A prompt is a request; a validator is a rule. Every promise a prompt makes has a deterministic check behind it: no focused tests, no fixed sleeps, no credentials in the file, no request to an address that is not the application under test, no Node capability a browser test has no business reaching for.
- A repair may not weaken a test. The quickest way to make a failing assertion pass is to delete it, so a fix that checks less than the test it was given is refused.
- Separation of duties. The person who proposed something cannot be the one who approves it; the MCP server can propose and send code and has no capability to approve, accept, share or delete, which a test enforces by reading the import graph.
- Every AI surface is measured.
npm run evalsgrades each prompt deterministically against structured output and compares the run with a hand-blessed baseline.
For agents (MCP)
PlaywrightGen is an MCP server, so Claude Code, Cursor or Copilot can read the approved intent instead of guessing: sixteen tools covering requirements, test cases, approved automation, recent failures, writing and proving a test on a live page, and proposing drafts for review. An agent gets exactly the rights of the person whose token it used.
Running it locally
npm install
npm run dev
Then npm run test:run for the suite, npm run typecheck, npm run lint,
and npm run build. Integration tests need TEST_DATABASE_URL pointing at a
database used for nothing else; they refuse anything that looks like
production.
Built with Next.js, TypeScript, PostgreSQL (Prisma), Clerk, Tailwind, Playwright, OpenAI and Stripe.
Environment
Runtime:
DATABASE_URL— PostgreSQL for the application.DIRECT_URL— optional direct connection preferred by migration commands.TEST_DATABASE_URL— a separate database for integration tests. It never falls back to either of the above.NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY,CLERK_SECRET_KEY,CLERK_WEBHOOK_SIGNING_SECRETOPENAI_API_KEY— server-only. Per-surface model overrides exist, for exampleOPENAI_REQUIREMENT_REVIEW_MODELandOPENAI_FAILURE_ANALYSIS_MODEL.UPSTASH_REDIS_REST_URL,UPSTASH_REDIS_REST_TOKEN— the per-minute and per-day AI allowances.RUNNER_INGEST_SECRET— signs live-run receipts, so a receipt proves a run of that exact code.BROWSERLESS_API_KEY— the remote browser the free tools and proving use.EXAMPLE_EVIDENCE_PROJECT_ID— optional: the one project whose evidence is published publicly at/proof/example.
GitHub integration (separate values per environment):
GITHUB_APP_ID,GITHUB_APP_PRIVATE_KEY,GITHUB_APP_SLUG,GITHUB_APP_CLIENT_ID,GITHUB_APP_CLIENT_SECRET,GITHUB_WEBHOOK_SECRETGITHUB_SETUP_STATE_SECRET— at least 32 characters, distinct from every other secret.NEXT_PUBLIC_APP_URL— the exact origin the GitHub callback returns to.
The App is held to a permission ceiling, checked on every installation and
refused if exceeded: metadata: read, contents: read and write,
pull_requests: read and write, issues: read. Contents write is what
opens a pull request with approved test code; pull-requests write is what
leaves the evidence note on it; issues read is what drafts a requirement from
a ticket. User and installation tokens are transient and are never logged or
stored.
Clerk webhooks go to /api/webhooks/clerk with
CLERK_WEBHOOK_SIGNING_SECRET set locally and in the deployment, subscribed
to:
user.created,user.updated,user.deletedorganization.created,organization.updated,organization.deletedorganizationMembership.created,organizationMembership.updated,organizationMembership.deleted
Local webhook delivery needs a secure tunnel to the local application. Never put a webhook secret in documentation or source control.
Operations
Reconcile one Clerk organization, dry-run by default:
npm run clerk:reconcile -- --organization-id org_example
# or
npm run clerk:reconcile -- --slug workspace-slug
Add --apply after reading the dry-run counts. It never sweeps every
organization.
Database:
npm run prisma:format
npm run prisma:validate
npm run prisma:generate
npm run prisma:migrate:dev
npm run test:database
Never commit credentials, secrets, .env or .env.local. Never point a
development migration or reset command at production.
Where the work is written down
docs/ROADMAP.md— what shipped, what is next, and what was deliberately not done.docs/DECISIONS.md— architecture decisions, each with its reason.docs/ARCHITECTURE.md,docs/PRODUCTION_READINESS.md— the shape of the system and the gates before a production deploy.examples/ci-proof— a disposable repository that proves the CI loop end to end.
PlaywrightGen MCP 질문
PlaywrightGen MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http playwrightgen https://playwrightgen.com/api/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
PlaywrightGen MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
이 MCP server로 AI 에이전트가 무엇을 할 수 있나요?
에이전트는 16개의 도구를 사용하여 요구사항, 테스트 케이스, 승인된 자동화, 최근 실패 사례를 관리하고 검토를 위한 초안을 제안할 수 있습니다.
AI 에이전트가 테스트를 승인할 수 있나요?
아니요, 직무 분리 원칙을 유지하기 위해 이 MCP server는 테스트를 승인, 수락, 공유 또는 삭제하는 권한이 제한되어 있습니다.
시스템은 테스트 품질을 어떻게 보장하나요?
결정론적 검증기(deterministic validators)를 사용하여 고정된 sleep이나 하드코딩된 자격 증명과 같은 문제를 방지하며, 어설션(assertion)을 약화시키는 수정 요청은 거부합니다.