Selenium

🚀 MCP Selenium WebDriver 使用説明

MCPはSelenium WebDriverを制御するためのプロトコルです。TCP通信を通じてリモートのWebDriverインスタンスにコマンドを送信することができます。

🚀 クイックスタート

MCP Selenium WebDriverを使用することで、Selenium WebDriverを効率的に制御できます。以下に、基本的な使い方を説明します。

✨ 主な機能

• TCP通信を通じてリモートのWebDriverインスタンスにコマンドを送信できます。
• 様々なWeb操作コマンドを提供し、要素の取得、クリック、テキスト入力などが可能です。

📦 インストール

MCPのダウンロード

MCP公式サイトから最新バージョンのMCPをダウンロードします。

インストール手順

1. ダウンロードしたファイルを解凍します。
2. mcp-server.jar とWebDriver実行ファイル（例：chromedriver.exe）を同じディレクトリに配置します。
3. 以下のコマンドを実行してMCPサーバーを起動します。

java -jar mcp-server.jar --port=4444

💻 使用例

基本的な使用法

import org.openqa.selenium.WebDriver;

public class Example {
    public static void main(String[] args) {
        WebDriver driver = new ChromeDriver();
        driver.navigate("https://www.example.com");
        
        // 要素を検索してクリック
        WebElement button = driver.findElement(By.cssSelector("#submit-btn"));
        button.click();
        
        // テキストを入力
        WebElement input = driver.findElement(By.id("search-box"));
        input.sendKeys("検索内容");
        
        driver.closeWindow();
    }
}

高度な使用法

以下は、MCPで提供される様々なコマンドの使用例です。

要素情報の取得

!wd getelementinfo <selector> [attribute]

• パラメータ:
  • <selector>: 要素セレクター（例：id、css、xpath）
  • [attribute]: オプション、取得する属性名。

要素のクリック

!wd click <selector>

テキストの入力

!wd type <selector> <text>

フォームの送信

!wd submit <selector>

ページタイトルの取得

!wd gettitle

要素の存在チェック

!wd elementexists <selector>

スクリーンショットの取得

!wd screenshot [outputPath]

📚 ドキュメント

サンプルプロジェクト

プロジェクト構造

your_project/
├── mcp-client-<version>.jar
├── mcp-server-<version>.jar
└── conf/
    └── mcp-config.json

設定ファイル mcp-config.json

{
  "servers": [
    {
      "name": "chrome",
      "host": "localhost",
      "port": 4444,
      "browser": "chrome"
    }
  ]
}

APIドキュメント

クラス Element

• getId()：要素のidを取得します。
• getCss()：CSSセレクターを使用して要素を検索します。
• getXpath()：XPath式を使用して要素を検索します。

インターフェース IWebDriver

• navigate(String url)：指定されたURLに移動します。
• closeWindow()：現在のウィンドウを閉じます。

📄 ライセンス

MCPプロジェクトはMITライセンスに準拠しています。