AI导哈

浏览器任务编排服务

基于Dedalus MCP框架的远程浏览器任务编排服务，提供会话管理、文件处理和配置文件管理功能。

  • by aryanma
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aryanma/browser-use-mcp

使用说明

浏览器使用mcp

浏览器使用Dedalus MCP框架构建的MCP。

此服务器不运行本地浏览器。每个工具都转发到浏览器使用云 API v2(https://api.browser-use.com)，由Dedalus Auth（DAuth）启用。

特性

  • 浏览器使用带有轮询助手的任务编排
  • 云浏览器会话生命周期和共享链接
  • 远程浏览器（CDP）会话管理
  • 档案管理
  • 工件的日志/输出URL检索

设置

cd browser-use-mcp
cp .env.example .env
# set BROWSER_USE_API_KEY
uv sync

运行服务器

uv run src/main.py

服务器终结点： http://127.0.0.1:8080/mcp

本地测试客户端

uv run src/client.py

交互式REPL客户端（DAuth）

uv run src/repl.py

这遵循了Gmail、Linear和Tinker所采用的DAuth交互模式 采样客户端并流式传输Dedalus运行器的响应。 它要求 dedalus_labs 您环境中的SDK包。

实时连接测试（无部署）

uv run pytest tests/test_connection_live.py -q

这使用基于以下内容的共享pytest夹具 ConnectionTester.from_env(browser_use_mcp) 和探测器浏览器使用API BROWSER_USE_API_KEY 从 .env。如果密钥丢失，则跳过测试。

无状态关联策略

此服务器有意设置为无状态(streamable_http_stateless=True)，所以 多步流必须通过浏览器使用返回的ID进行关联。

推荐模式：

  1. 调用创建端点(bu_session_create, bu_browser_session_create，或 bu_task_create).
  2. 持久化返回的ID(session_id, task_id，可选 cdp_url).
  3. 将这些ID明确地传递给后续呼叫。

在顶层创建端点返回类型ID字段，以使其可靠 LM和MCP客户端。

环境

  • DEDALUS_AS_URL 默认 https://as.dedaluslabs.ai
  • BROWSER_USE_API_URL 默认 https://api.browser-use.com
  • BROWSER_USE_API_KEY 必需的

工具组

计费

  • bu_billing_account_get

任务

  • bu_task_create
  • bu_task_get
  • bu_task_list
  • bu_task_get_status
  • bu_task_update
  • bu_task_wait
  • bu_task_run
  • bu_task_get_logs_url
  • bu_task_get_output_file_url

会话

  • bu_session_create
  • bu_session_list
  • bu_session_get
  • bu_session_update
  • bu_session_delete
  • bu_session_public_share_create
  • bu_session_public_share_get
  • bu_session_public_share_delete

远程浏览器会话（CDP）

  • bu_browser_session_create
  • bu_browser_session_list
  • bu_browser_session_get
  • bu_browser_session_update

文件

  • bu_session_file_presigned_url_create
  • bu_browser_file_presigned_url_create

档案

  • bu_profile_create
  • bu_profile_list
  • bu_profile_get
  • bu_profile_update
  • bu_profile_delete

推荐使用模式

  1. 一枪处决： bu_task_run
  2. 后续工作流程：
    • 创建/重用会话(bu_session_create)
    • 使用以下命令运行任务 session_id 或 session_settings
    • 投票与 bu_task_wait （内部使用轻量级状态端点）
  3. 调试/操作：
    • bu_task_get_logs_url
    • bu_task_get_output_file_url
    • bu_task_list
  4. 人工审核/分享：
    • bu_session_public_share_create

备注

  • 身份验证是基于标头的(X-Browser-Use-API-Key)并通过以下方式处理 道。
  • 此服务器有意避免使用本地浏览器运行时API。
  • 为无状态关联创建端点返回类型ID引用。

许可证

麻省理工学院

相关 MCP