MCP 接入令牌

生成令牌后,粘贴到 Cursor 或开发工具即可启动 chrome.exe,并继续控制浏览器实例。

加载中…

接入 Cursor / 开发工具

Cursor HTTP MCP

在项目或用户级 mcp.json 中填入你的令牌:

{
  "mcpServers": {
    "jimu-browser": {
      "url": "https://api.jimuie.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <你的MCP令牌>"
      }
    }
  }
}

其它 HTTP MCP 客户端

支持 HTTP MCP 的客户端只需填写端点和鉴权头:

Type: HTTP
Endpoint: https://api.jimuie.com/api/v1/mcp
Header: Authorization: Bearer <你的MCP令牌>

本地开发环境

在本地测试时,可以把 URL 指向 localhost:

{
  "mcpServers": {
    "jimu-browser-local": {
      "url": "http://localhost:8090/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <你的MCP令牌>"
      }
    }
  }
}

授权码启动浏览器

Cursor 端到端流程

当你只有浏览器授权码时,Cursor 不需要也不应该知道 AES 加密密钥。先调用 browser.launch_token 让平台服务端生成短期一次性 launch_token,再调用 browser.launchbrowser.launch_args

1. browser.launch_token
   输入 auth_code
   返回 launch_token

2. browser.launch / browser.launch_args
   输入 launch_token + mode + chrome_path + user_data_dir + fp_config_path
   启动 chrome.exe --launch-token=<launch_token>

服务端只返回加密后的 launch_token 和时效提示,不回传授权码,也不会把 license.token_encryption_key 暴露给 MCP 客户端。

可用工具

browser.list_tabs

browser:read

列出当前浏览器实例中所有打开的标签页,返回标签 ID 和 URL。

参数:

{"method":"tools/call","params":{"name":"browser.list_tabs","arguments":{}}}

browser.open_tab

browser:control

创建新标签页并导航到指定 URL,返回新标签 ID。

参数:url (string, 必需) · active (bool, 可选)

{"method":"tools/call","params":{"name":"browser.open_tab","arguments":{"url":"https://example.com","active":true}}}

browser.navigate

browser:control

在指定标签页中导航到新 URL,不创建新标签。

参数:tab_id (string, 必需) · url (string, 必需)

{"method":"tools/call","params":{"name":"browser.navigate","arguments":{"tab_id":"<tab_id>","url":"https://example.com"}}}

browser.evaluate

browser:evaluate

在指定标签页的页面上下文中执行 JavaScript 表达式,同步返回结果。

参数:tab_id (string, 必需) · js (string, 必需)

{"method":"tools/call","params":{"name":"browser.evaluate","arguments":{"tab_id":"<tab_id>","js":"document.title"}}}

browser.screenshot

browser:screenshot

捕获标签页可见区域的屏幕截图,返回 Base64 编码的图像数据。

参数:tab_id (string, 必需) · format (string, 可选: png/jpeg/webp, 默认 png)

{"method":"tools/call","params":{"name":"browser.screenshot","arguments":{"tab_id":"<tab_id>","format":"png"}}}

browser.close_tab

browser:control

关闭指定的标签页,不能关闭最后一个标签。

参数:tab_id (string, 必需)

{"method":"tools/call","params":{"name":"browser.close_tab","arguments":{"tab_id":"<tab_id>"}}}

browser.wait_for_load

browser:control

等待指定标签页加载完成,返回当前 URL、标题和加载状态。

参数:tab_id (string, 必需) · timeout_seconds (number, 可选)

{"method":"tools/call","params":{"name":"browser.wait_for_load","arguments":{"tab_id":"<tab_id>"}}}

control.status

browser:read

读取 MJYBrowser Control API 状态,用于确认 41730 管理面是否可用。

参数:control_token (string, 可选)

{"method":"tools/call","params":{"name":"control.status","arguments":{"control_token":"<token>"}}}

control.http_request

browser:control

调用 Control API HTTP 管理面,覆盖环境、标签、Cookie、Storage 等低频管理动作。

参数:path (string, 必需) · method/control_token/body (可选)

{"method":"tools/call","params":{"name":"control.http_request","arguments":{"path":"/v1/tabs","control_token":"<token>"}}}

browser.mode_status

browser:read

读取当前运行模式、版本和能力列表,区分 native / global-fp / managed-tabs。

参数:control_token (string, 可选)

{"method":"tools/call","params":{"name":"browser.mode_status","arguments":{"control_token":"<token>"}}}

browser.launch_token

browser:control

把浏览器授权码换成短期一次性加密 launch_token,供 browser.launch_args 或 browser.launch 使用。

参数:auth_code (string, 必需);不会回传授权码或 AES key。

{"method":"tools/call","params":{"name":"browser.launch_token","arguments":{"auth_code":"<浏览器授权码>"}}}

browser.launch_args

browser:control

生成可直接启动 chrome.exe 的完整参数;如果只有浏览器授权码,先调用 browser.launch_token 生成 launch_token。

参数:mode (必需) · chrome_path/launch_token/user_data_dir/cache_dir/proxy_server/cdp_port/fp_config_path/start_url 等

{"method":"tools/call","params":{"name":"browser.launch_args","arguments":{"mode":"global-fp","chrome_path":"D:\\MJYBrowser\\chrome.exe","user_data_dir":"D:\\profiles\\env-a\\profile","cache_dir":"D:\\profiles\\env-a\\cache","proxy_server":"socks5://127.0.0.1:1080","fp_config_path":"D:\\profiles\\env-a\\fp-config.json","cdp_port":41729}}}

browser.launch

browser:control

按 browser.launch_args 的同一参数模型直接启动 chrome.exe;如果只有浏览器授权码,先调用 browser.launch_token。

mode:native=原生不改指纹 · global-fp=整实例共享一个环境 · managed-tabs=每个托管标签绑定独立环境

{"method":"tools/call","params":{"name":"browser.launch","arguments":{"mode":"global-fp","chrome_path":"D:\\MJYBrowser\\chrome.exe","launch_token":"<launch_token>","user_data_dir":"D:\\profiles\\env-a\\profile","fp_config_path":"D:\\profiles\\env-a\\fp-config.json","cdp_port":41729}}}

env.create

browser:control

创建 managed-tabs 环境,并注入 fp-config、代理和独立存储边界。

参数:env_id/control_token/fp_config_json/fp_config_path/proxy_server 等

{"method":"tools/call","params":{"name":"env.create","arguments":{"env_id":"env-a","fp_config_json":{"navigator":{"platform":"Win32"}}}}}

env.update

browser:control

更新已有 managed-tabs 环境的 fp-config 或代理配置。

参数:env_id (必需) · fp_config_json/fp_config_path/proxy_server 等

{"method":"tools/call","params":{"name":"env.update","arguments":{"env_id":"env-a","fp_config_path":"D:\\profiles\\env-a\\fp-config.json"}}}

managed_tab.open

browser:control

在指定环境中打开托管标签,继承该环境的指纹、代理和存储。

参数:env_id (必需) · url/control_token (可选)

{"method":"tools/call","params":{"name":"managed_tab.open","arguments":{"env_id":"env-a","url":"https://example.com"}}}

managed_tab.create

browser:control

一步创建 managed-tabs 环境并打开单个托管标签,适合“单标签单环境”自动化场景。

参数:env_id (必需) · fp_config_json/fp_config_path/proxy_server/url/control_token (可选)

{"method":"tools/call","params":{"name":"managed_tab.create","arguments":{"env_id":"env-a","fp_config_path":"D:\\profiles\\env-a\\fp-config.json","proxy_server":"socks5://127.0.0.1:1080","url":"https://example.com"}}}

env.list / env.delete

browser:read / browser:control

列出或删除 managed-tabs 环境;删除环境会关闭其托管标签。

参数:env.delete 需要 env_id

{"method":"tools/call","params":{"name":"env.list","arguments":{"control_token":"<token>"}}}

acceptance.browserscan

browser:control

新开标签运行 BrowserScan 快速验收,返回页面标题、URL、分数线索和可见文本摘要。

参数:wait_seconds (number, 可选,默认 45)

{"method":"tools/call","params":{"name":"acceptance.browserscan","arguments":{"wait_seconds":45}}}

acceptance.gongjux

browser:control

新开标签运行 gongjux 指纹页快速验收,返回页面可见检测摘要。

参数:wait_seconds (number, 可选,默认 30)

{"method":"tools/call","params":{"name":"acceptance.gongjux","arguments":{"wait_seconds":30}}}