生成令牌后,粘贴到 Cursor 或开发工具即可启动 chrome.exe,并继续控制浏览器实例。
在项目或用户级 mcp.json 中填入你的令牌:
{
"mcpServers": {
"jimu-browser": {
"url": "https://api.jimuie.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer <你的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 不需要也不应该知道 AES 加密密钥。先调用 browser.launch_token 让平台服务端生成短期一次性 launch_token,再调用 browser.launch 或 browser.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 客户端。
列出当前浏览器实例中所有打开的标签页,返回标签 ID 和 URL。
参数:无
{"method":"tools/call","params":{"name":"browser.list_tabs","arguments":{}}}创建新标签页并导航到指定 URL,返回新标签 ID。
参数:url (string, 必需) · active (bool, 可选)
{"method":"tools/call","params":{"name":"browser.open_tab","arguments":{"url":"https://example.com","active":true}}}在指定标签页中导航到新 URL,不创建新标签。
参数:tab_id (string, 必需) · url (string, 必需)
{"method":"tools/call","params":{"name":"browser.navigate","arguments":{"tab_id":"<tab_id>","url":"https://example.com"}}}在指定标签页的页面上下文中执行 JavaScript 表达式,同步返回结果。
参数:tab_id (string, 必需) · js (string, 必需)
{"method":"tools/call","params":{"name":"browser.evaluate","arguments":{"tab_id":"<tab_id>","js":"document.title"}}}捕获标签页可见区域的屏幕截图,返回 Base64 编码的图像数据。
参数:tab_id (string, 必需) · format (string, 可选: png/jpeg/webp, 默认 png)
{"method":"tools/call","params":{"name":"browser.screenshot","arguments":{"tab_id":"<tab_id>","format":"png"}}}关闭指定的标签页,不能关闭最后一个标签。
参数:tab_id (string, 必需)
{"method":"tools/call","params":{"name":"browser.close_tab","arguments":{"tab_id":"<tab_id>"}}}等待指定标签页加载完成,返回当前 URL、标题和加载状态。
参数:tab_id (string, 必需) · timeout_seconds (number, 可选)
{"method":"tools/call","params":{"name":"browser.wait_for_load","arguments":{"tab_id":"<tab_id>"}}}读取 MJYBrowser Control API 状态,用于确认 41730 管理面是否可用。
参数:control_token (string, 可选)
{"method":"tools/call","params":{"name":"control.status","arguments":{"control_token":"<token>"}}}调用 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>"}}}读取当前运行模式、版本和能力列表,区分 native / global-fp / managed-tabs。
参数:control_token (string, 可选)
{"method":"tools/call","params":{"name":"browser.mode_status","arguments":{"control_token":"<token>"}}}把浏览器授权码换成短期一次性加密 launch_token,供 browser.launch_args 或 browser.launch 使用。
参数:auth_code (string, 必需);不会回传授权码或 AES key。
{"method":"tools/call","params":{"name":"browser.launch_token","arguments":{"auth_code":"<浏览器授权码>"}}}生成可直接启动 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_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}}}创建 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"}}}}}更新已有 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"}}}在指定环境中打开托管标签,继承该环境的指纹、代理和存储。
参数:env_id (必需) · url/control_token (可选)
{"method":"tools/call","params":{"name":"managed_tab.open","arguments":{"env_id":"env-a","url":"https://example.com"}}}一步创建 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"}}}列出或删除 managed-tabs 环境;删除环境会关闭其托管标签。
参数:env.delete 需要 env_id
{"method":"tools/call","params":{"name":"env.list","arguments":{"control_token":"<token>"}}}新开标签运行 BrowserScan 快速验收,返回页面标题、URL、分数线索和可见文本摘要。
参数:wait_seconds (number, 可选,默认 45)
{"method":"tools/call","params":{"name":"acceptance.browserscan","arguments":{"wait_seconds":45}}}新开标签运行 gongjux 指纹页快速验收,返回页面可见检测摘要。
参数:wait_seconds (number, 可选,默认 30)
{"method":"tools/call","params":{"name":"acceptance.gongjux","arguments":{"wait_seconds":30}}}