MCP-Browse

MCP-Browse

自動化および E コマースサイトとのやり取りを目的としたブラウザー制御プロトコルです。

概要

MCP-Browse は、リモートプロトコルを介してブラウザー操作を制御するための、シンプルで効率的なインターフェースを提供します。特に、次のような一般的な E コマースサイトでの操作に重点を置いています。

• ページへの移動
• 要素のクリック
• フォームデータの入力
• 画像やファイルのダウンロード
• JavaScript の実行

すべての操作では、効率的かつ型安全な通信のために Protocol Buffers を使用します。

プロトコル設計

このプロトコルは、ブラウザーでのユーザー操作を表す「ジェスチャー」を中心に設計されています。

1. Navigate - リダイレクト処理を指定して URL にアクセスします
2. Click - ID または CSS セレクターを使って要素をクリックします
3. Input - フォームフィールドに値を入力します（テキスト、チェックボックス、セレクトドロップダウン）
4. Download - 画像やファイルを取得します
5. ExecuteScript - ページ上で JavaScript を実行して結果を取得します

ブラウザーのジェスチャー操作（Navigate、Click、Input）は、次の内容を含むストリーミングレスポンスを返します。

• 0 件以上のリダイレクトイベント
• ページコンテンツまたはエラー情報
• 完了イベント

ユーティリティ操作（Download、ExecuteScript）は、要求されたデータを含む単一のレスポンスを返します。

使用例

// Create a client
// client := NewMCPBrowserServiceClient(...)

// Navigate to a product page
navigateReq := apiv1.NavigateRequest_builder{
    Url: stringPtr("https://example-shop.com/products"),
    AllowRedirects: boolPtr(true),
}.Build()

// Process the response stream
// stream, err := client.Navigate(context.Background(), navigateReq)
// handleResponseStream(stream)

// Click on a product
clickReq := apiv1.ClickRequest_builder{
    CssSelector: stringPtr(".product-item"),
}.Build()

// Process the response stream
// stream, err = client.Click(context.Background(), clickReq)
// handleResponseStream(stream)

// Add to cart
clickReq = apiv1.ClickRequest_builder{
    CssSelector: stringPtr(".add-to-cart-button"),
}.Build()

// Process the response stream
// stream, err = client.Click(context.Background(), clickReq)
// handleResponseStream(stream)

ビルドと実行

前提条件

• Go 1.18+
• Protocol Buffers コンパイラー

セットアップ

1. リポジトリをクローンします
2. 依存関係をインストールします。

   go mod download
   

3. Protocol Buffer コードを生成します。

   buf generate
   

テストの実行

go test ./...

ライセンス

MIT ライセンス