userdispatch-mcp は何をしますか？
UserDispatch MCPを使用して、最新のウェブアプリケーションにおけるユーザー操作の管理とシミュレーションを行い、テストの正確性と信頼性を向上させます。
概要
このMCPサーバーは、ウェブアプリケーションに対するユーザー操作（クリック、テキスト入力、フォーム送信、ページ遷移など）をプログラム的にシミュレートし、AIエージェントがテストやスクリーンスクリプト作成を自動化できるようにします。
主な機能
- ユーザー操作の記録と再生: 実際のユーザー操作を記録し、自動テストとして再生。
- ブラウザ自動化: ヘッドレスブラウザでの操作をサポート。
- 状態管理: アプリケーションの状態変化を追跡し、操作に応じたレスポンスを検証。
- アサーション: 要素の表示、テキスト内容、URL変更などに対するチェック機能。
対応プラットフォーム
- Claude Code
- Cursor
- Codex
- その他 MCP 対応クライアント
クイックスタート
インストール
npm install @baljeet99/userdispatch-mcp
設定
MCPクライアントの設定ファイル（例: claude_desktop_config.json）に以下を追加します。
{
"mcpServers": {
"userdispatch": {
"command": "npx",
"args": ["-y", "@baljeet99/userdispatch-mcp"],
"env": {
"BROWSER_HEADLESS": "true",
"TARGET_URL": "https://example.com"
}
}
}
}
使用例
AIエージェントへの指示例:
ユーザー操作をシミュレートし、ログインフォームのテストを実行してください。
https://myapp.com/loginにアクセス- ユーザー名フィールドに
testuserと入力- パスワードフィールドに
securepasswordと入力- ログインボタンをクリック
- ダッシュボード画面が表示されることを確認
環境変数
| 変数名 | 説明 | デフォルト値 |
|---|---|---|
BROWSER_HEADLESS | ヘッドレスモードでブラウザを起動 | true |
TARGET_URL | テスト対象のアプリケーションURL | - |
VIEWPORT_WIDTH | ブラウザのビューポート幅 | 1280 |
VIEWPORT_HEIGHT | ブラウザのビューポート高さ | 720 |
トラブルシューティング
- ブラウザが起動しない場合:
BROWSER_HEADLESSをfalseに設定してデバッグログを確認してください。 - 要素が見つからない場合: ページが完全に読み込まれるまで待機するよう、ツール呼び出し時に
waitForSelectorオプションを使用してください。
ライセンス
MIT