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 }。ファイルcontent (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万分の秒は、Playwright の testIdAttribute で data-test を使うため、まだ getByTestId を出力してます。role を持たない汎用の data-testid ノードでも getByTestId にマップされ、getByRole('generic') にマップされることはありません。

テスト

npx vitest run

ライセンス

MIT