pagesnap-mcp

MCP-Server, der bestehende PageSnap-Session-Pakete kapselt, damit ein LLM Sessions auflisten, Locators lesen und sie Playwright, Selenium oder Cypress zuordnen kann.

Dies ist KEIN Erfassungstool. Es öffnet keinen Browser, scannt keine URLs automatisch und ruft keine Browser ab. Playwright ist keine Abhängigkeit.

Die Erfassung erfolgt in pagesnap-playwright oder pagesnap-selenium. Richten Sie diesen Server auf einen übergeordneten Ordner mit Session-Paketen aus (flow.md plus yaml plus optional PROMPT.md).

Ausführung

npm install
npm run build
node dist/index.js

Der Prozess spricht MCP über stdio und wartet auf stdin. Er wirkt in einem Terminal eingefroren; das ist erwartet. Beenden Sie ihn mit Ctrl+C. Optionale Umgebungsvariable: PAGESNAP_SESSIONS_DIR (Standard ./sessions) ist der übergeordnete Ordner der PageSnap-Session-Ordner.

Related MCP server: Playwright MCP

Cursor-MCP-Konfiguration

Beispiel .cursor/mcp.json. Richten Sie PAGESNAP_SESSIONS_DIR auf ein übergeordnetes PageSnap-Session-Verzeichnis aus, z. B. 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"
      }
    }
  }
}

Dieser Server liest nur Pakete, die bereits auf der Festplatte liegen. Er ist kein Erfassungstool.

Werkzeuge

Token-effizient: list_sessions und read_session geben zuerst Schlüssel und Zusammenfassungen zurück. Die Inhalte der YAML-Dateien werden nicht ausgegeben.

• list_sessions: keine Argumente. Sessions aus PAGESNAP_SESSIONS_DIR.

• read_session: { session }. flow.md, YAML-Dateinamen, geparste Steuerelemente (max. 200).

• map_locator: { by, value, name?, framework? }. snippet, score, stability. framework: playwright|selenium|cypress (Standard playwright).

• get_prompt: { session, framework? }. PROMPT.md falls vorhanden, andernfalls ein erzeugter Prompt.

Locators

YAML-Werte: testid, role, label, id, name, placeholder, linkText, css, xpath. Scores entsprechen PageSnap: testid 98, role 95, label/id 90, name 88, placeholder 85, linkText 75, css 60, xpath 40. Playwright testid wird immer auf page.getByTestBy(...) abgebildet. Sauce Demo verwendet data-test über Playwright testIdAttribute; geben Sie dennoch getByTestBy aus. Generische data-testid-Knoten ohne Rolle werden weiterhin auf getBytestGetBy abgebildet, niemals auf getByRole('generic').

Tests

npx vitest run

Lizenz

MIT