MCP IE Migration VRT

Edge IEモードの移行前画面とChromium Edgeの移行後画面を、2つのSeleniumセッションで操作・撮影し、Playwright Testで画像比較するMCPサーバーです。

Edge IE mode ── Selenium screenshot ─┐
                                     ├─ Playwright VRT ─ pass / diff / report
Chromium Edge ─ Selenium screenshot ─┘

必要環境

• Windows 10/11またはWindows Server
• Microsoft Edge Stable
• Edge IEモードとEnterprise Mode Site List
• IEDriverServer 4.0.0.0以上
• ログオン中の非昇格Windowsセッション
• Edge/IEズームとWindows表示倍率を100%に固定

IEモードはheadless実行できません。RDP利用中は、撮影の途中で解像度や表示倍率を変更しないでください。

事前診断:

powershell -ExecutionPolicy Bypass -File scripts\windows\Test-IeMigrationVrtPrerequisites.ps1

インストール

1. MCPBをインストール

最新のGitHub Releaseから.mcpbをダウンロードし、Windows上で開いてClaude Desktopへインストールします。

インストール画面でVRT成果物と通常スクリーンショットの保存先を指定してください。MCPBにはMCPサーバーと実行時依存関係が含まれます。

2. Skillをインストール

Claude Code:

npx skills add rayven122/mcp-ie-migration-vrt --agent claude-code

Codex:

npx skills add rayven122/mcp-ie-migration-vrt --agent codex

SkillはMCPBには含まれず、別途インストールされます。

使い方

エージェントへ次のように依頼します。

$ie-migration-vrt を使って、移行前と移行後の注文一覧を同じ検索結果まで操作し、画面差分を確認してください。

エージェントは次の順に処理します。

1. start_vrt_browsersでEdge IEモードとChromium Edgeを起動
2. sessionIdを指定して両画面を同じ業務状態まで個別に操作
3. vrtで現在の画面を比較
4. before.png、after.png、diff.png、report.jsonを保存
5. 必要に応じて移行後画面を修正し、再比較
6. 両セッションを終了

既定の比較条件:

• Viewport: 1200 x 650
• maxDiffPixelRatio: 0.005
• threshold: 0.2
• ブラウザのタブやアドレスバーは撮影対象外
• 画像サイズが異なる場合はリサイズせず失敗

詳細なチェックポイントと撮影規約はdocs/vrt-standard.mdを参照してください。MCPからはvrt-standard://currentで取得できます。

主なMCP Tool

Tool	用途
start_vrt_browsers	IEモードとChromium Edgeを同時起動
navigate / interact / send_keys	指定セッションを操作
accessibility_snapshot	画面構造と操作対象を取得
execute_script	DOM・computed style・スクロールを確認
diagnostics	console・JavaScript error・networkログを取得
vrt	2セッションの現在画面を比較
close_session	指定セッションを終了

その他のSelenium ToolもsessionIdを指定して利用できます。

補足

• Windows/IIS・ASP.NET 4.8・VB.NET Web Formsで動作確認済みです。
• VRT成果物の保存先はMCP_VRT_ARTIFACT_DIRで変更できます。
• MCPB署名は公式CLIの既知不具合により保留中です。詳細はdocs/mcpb-signing.mdを参照してください。
• 開発・ローカルビルドはpackage.jsonのnpm scriptsを参照してください。

License

MIT