pagesnap-mcp

MCP-сервер, который оборачивает существующие пакеты сессий PageSnap, чтобы LLM мог перечислять сессии, читать локаторы и сопоставлять их с Playwright, Selenium или Cypress.

Это НЕ инструмент захвата. Он не открывает браузер, не сканирует URL автоматически и не загружает браузеры. Playwright не является зависимостью.

Захват выполняется в pagesnap-playwright или pagesnap-selenium. Укажите этому серверу родительскую папку с пакетами сессий (flow.md плюс yaml и опционально PROMPT.md).

Как запустить

npm install
npm run build
node dist/index.js

Процесс общается через MCP по stdio и ждёт ввода в stdin. В терминале он выглядит зависшим; это нормально. Остановите его с помощью Ctrl+C. Необязательная переменная среды: PAGESNAP_SESSIONS_DIR (по умолчанию ./sessions) — родительская папка каталогов сессий PageSnap.

Related MCP server: Playwright MCP

Конфигурация MCP для Cursor

Пример .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, если есть, иначе сформированный промпт.

Локаторы

Значения by в YAML: 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 использует data-test через testIdAttribute в Playwright; всё равно следует выводить getByTestId. Обычные узлы с data-testid без роли по-прежнему сопоставляются с getByTestId, а никогда с getByRole('generic').

Тесты

npx vitest run

Лицензия

MIT