Selenix-MCP-Server

Selenix MCP Server

Claude Desktop を Model Context Protocol 経由で Selenix に接続します。Claude とチャットして、ブラウザー自動化テストの作成、実行、デバッグ、管理ができます。組み込みの AI アシスタントと同じように使えますが、Claude を利用します。

前提条件

• Selenix デスクトップアプリがインストールされていること
• Claude Desktop がインストールされていること
• Node.js 18 以降

Selenix でブリッジを有効にする

以下のセットアップ方法を使用する前に、Selenix でブリッジを有効にしてください。

1. Selenix を開きます
2. System Settings（サイドバーの歯車アイコン）に移動します
3. MCP Server セクションまでスクロールします
4. Enable MCP Server を Yes に設定します

これにより、MCP サーバーが接続するローカルブリッジサーバーが起動します。

セットアップ

以下のいずれかの方法を選択してください。

オプション A：npm 経由でインストール（推奨）

npm install -g @selenix/mcp-server

次に、グローバル npm パスを確認します。

npm root -g

Claude Desktop の設定ファイルを開きます。

• Windows：Win+R を押し、%APPDATA%\Claude\claude_desktop_config.json を貼り付けて、Enter を押します
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json を開きます

npm root -g の出力にパスを置き換えて、Selenix MCP サーバーを追加します。

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["<npm-root-path>/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

例（nvm を使う Windows）：

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/Users/YourName/AppData/Local/nvm/v18.20.8/node_modules/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

例（macOS/Linux）：

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["/usr/local/lib/node_modules/@selenix/mcp-server/dist/bundle.js"]
    }
  }
}

すでに他の MCP サーバーを設定している場合は、既存の "mcpServers" オブジェクト内に "selenix" を追加します。

オプション B：同梱版を使用（npm 不要）

Selenix をデスクトップアプリとしてインストールした場合、MCP サーバーはすでに同梱されています。インストールは不要です。Claude Desktop から同梱ファイルを指定するだけです。

Selenix のインストールフォルダーを見つけて、resources/mcp-server/index.js を探し、Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/path/to/Selenix/resources/mcp-server/index.js"]
    }
  }
}

Windows の一般的なパス：

C:/Users/YourName/AppData/Local/Programs/Selenix/resources/mcp-server/index.js

オプション C：手動ダウンロード

1. npm パッケージページまたはリリースページから bundle.js をダウンロードします
2. マシン上の任意の場所（例：C:/selenix-mcp/bundle.js）に保存します
3. Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "selenix": {
      "command": "node",
      "args": ["C:/selenix-mcp/bundle.js"]
    }
  }
}

Node.js は引き続き必要です。MCP サーバーは、他の依存関係を持たない単一の JavaScript ファイルです。

動作確認

設定を編集した後、Claude Desktop を再起動します。チャット入力欄に Selenix ツールのアイコン（ハンマー）が表示されます。

Claude に次のように尋ねてみてください。

• 「Selenix プロジェクトにはどのようなテストがありますか？」
• 「google.com を開いて 'selenium automation' を検索するテストを作成してください」
• 「現在のテストを実行して、失敗があれば修正してください」
• 「ブラウザーのスクリーンショットを撮ってください」

仕組み

Claude Desktop <--stdio--> MCP Server <--HTTP--> Bridge Server (inside Selenix)

MCP サーバーは、Claude のツール呼び出しを、Selenix 内で動作するブリッジサーバーへの HTTP リクエストに変換します。ブリッジは Selenix の内部機能にフルアクセスでき、組み込みの AI アシスタントと同じ機能を利用できます。

• ブリッジは 127.0.0.1（localhost）のみでリッスンするため、ネットワークには公開されません
• 認証には、Selenix の起動時に自動生成されるベアラートークンを使用します
• 接続設定は ~/.selenix/bridge.json に保存され、呼び出しのたびに読み込まれるため、Selenix を再起動しても Claude Desktop を再起動する必要はありません

利用可能なツール

読み取りと検査

ツール	説明
get_screenshot	ブラウザーウィンドウのスクリーンショットを撮影します
get_page_html	インタラクティブ要素に注釈を付けたページの HTML を取得します
get_search_html	正規表現パターンでページの HTML を検索します
get_selected_command_info	コマンドの対象要素に関する DOM コンテキストを取得します
get_current_test	現在のテスト内のすべてのコマンドを取得します
get_test_list	プロジェクト内のすべてのテストを一覧表示します
get_test_by_name	名前でテストを取得します
get_command_list	使用可能なすべての Selenix コマンドを一覧表示します
get_command_info	特定のコマンドの詳細なドキュメントを取得します
get_project_info	プロジェクトのメタデータを取得します
get_active_suite	アクティブなテストスイートを取得します
get_step_results	前回のテスト実行の成功／失敗結果を取得します
get_logs	最近のログ（すべての種類）を、1 ページあたり 20 件、最新のものから順に取得します。ページネーションには任意の page パラメーターを使用します。
get_workspace_context	現在のワークスペースの概要を取得します

作成と実行

ツール	説明
add_commands	指定した位置にコマンドをテストへ追加します
run_test	テストを実行し、結果を待ちます（最大 2 分）
clear_and_replace_commands	テスト内のすべてのコマンドを置き換えます
fix_commands	コマンドの更新、削除、挿入によって対象を絞った修正を適用します

トラブルシューティング

「Selenix bridge config を読み取れません」 Selenix が起動していないか、MCP Server が有効になっていません。Selenix を開き、System Settings に移動して、Enable MCP Server を Yes に設定してください。

「Selenix bridge に接続できません」 Selenix が再起動した直後の可能性があります。リクエストをもう一度試してください。MCP サーバーは新しい接続情報を自動的に取得します。

Claude Desktop にツールが表示されない 設定ファイルを編集した後、Claude Desktop を再起動したことを確認してください。設定 JSON が有効であること（末尾に余分なカンマがないこと、かっこが正しいこと）を確認してください。

設定変更後に Claude Desktop が開かない 設定 JSON の形式が正しくない可能性があります。テキストエディターで設定ファイルを開き、JSON の構文を修正してから、もう一度試してください。よくある問題：項目間のカンマがない、最後の項目の後にカンマがある。

アンインストール

npm uninstall -g @selenix/mcp-server

次に、Claude Desktop の設定ファイルから "selenix" の項目を削除し、Claude Desktop を再起動してください。