MCP-Browse

MCP-Browse

用于自动化和与电商网站交互的浏览器控制协议。

概述

MCP-Browse 通过远程协议提供简洁、流畅的浏览器交互控制界面。它尤其专注于常见的电商网站交互，例如：

• 浏览页面
• 点击元素
• 输入表单数据
• 下载图像和文件
• 执行 JavaScript

所有操作都使用 Protocol Buffers 进行高效、类型化的通信。

协议设计

该协议围绕代表用户与浏览器交互的“操作”进行设计：

1. 导航 - 访问 URL，并可选择处理重定向
2. 点击 - 使用 ID 或 CSS 选择器点击元素
3. 输入 - 在表单字段中输入值（文本、复选框、下拉列表）
4. 下载 - 获取图像或文件
5. ExecuteScript - 在页面上运行 JavaScript 并获取结果

浏览器操作（Navigate、Click、Input）会返回流式响应，其中包括：

• 零个或多个重定向事件
• 页面内容或错误信息
• 完成事件

实用操作（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 许可证