pagesnap-mcp

기존 PageSnap 세션 팩을 감싸는 MCP 서버로, LLM이 세션을 나열하고 로케이터를 읽어 Playwright, Selenium 또는 Cypress로 매핑할 수 있게 합니다.

이 도구는 캡처 도구가 아닙니다. 브라우저를 열지 않고, URL을 자동 스캔하거나 브라우저를 내려받지 않습니다. Playwright는 의존성이 아닙니다.

캡처는 pagesnap-playwright 또는 pagesnap-selenium에서 수행됩니다. 이 서버를 세션 팩(flow.md + yaml + 선택적으로 PROMPT.md)의 부모 폴더로 지정하세요.

실행 방법

npm install
npm run build
node dist/index.js

이 프로세스는 stdio를 통해 MCP로 통신하며 stdin을 대기합니다. 터미널에서 멈춘 것처럼 보일 수 있지만 이는 정상입니다. Ctrl+C로 종료하세요. 선택적 환경 변수: PAGESNAP_SESSIONS_DIR(기본값 ./sessions)은 PageSnap 세션 폴더의 부모 디렉터리입니다.

Related MCP server: Playwright MCP

Cursor MCP 설정

예시: .cursor/mcp.json. PAGESNAP_SESSIONS_DIR을 PageSnap 세션 부모 폴더(예: playwright-ts-framework/snapshots)로 지정하세요:

{
  "mcpServers": {
    "pagesnap": {
      "command": "node",
      "args": [
        "/absolute/path/to/pagesnap-mcp/dist/index.js"
      ],
      "env": {
        "PAGESNAP_SESSIONS_DIR": "/absolute/path/to/playwright-ts-framework/snapshots"
      }
    }
  }
}

이 서버는 이미 디스크에 존재하는 팩만 읽습니다. 캡처 도구가 아닙니다.

도구

토큰 효율적 처리: list_sessions와 read_session은 먼저 키와 요약만 반환합니다. YAML 파일 본문은 덤프하지 않습니다.

• list_sessions: 인자 없음. PAGESNAP_SESSIONS_DIR에서 세션을 나열합니다.

• read_session: { session }. flow.md, yaml 파일 이름, 파싱된 컨트롤(최대 200개)을 반환합니다.

• map_locator: { by, value, name?, framework? }. 스니펫, 점수, 안정성을 반환합니다. framework: playwright|selenium|cypress(기본값 playwright).

• get_prompt: { session, framework? }. PROMPT.md가 있으면 그 내용을, 없으면 합성된 프롬프트를 반환합니다.

로케이터

YAML by 값: testid, role, label, id, name, placeholder, linkText, css, xpath. 점수는 PageSnap과 동일합니다: testid 98, role 95, label/id 90, name 88, placeholder 85, linkText 75, css 60, xpath 40. Playwright에서 testid는 항상 page.getByTestId(...)로 매핑됩니다. Sauce Demo는 Playwright testIdAttribute를 통해 data-test를 사용하지만, 여전히 getByTestId를 생성해야 합니다. role이 없는 일반 data-testid 노드도 getByTestId로 매핑하며, getByRole('generic')으로 매핑하지 않습니다.

테스트

npx vitest run

라이선스

MIT