cmux浏览器mcp
MCP（模型上下文协议）服务器，使Claude Code能够完全控制 cmux的嵌入式浏览器。
打开页面、点击按钮、填写表单、截图、运行JavaScript——全部 Claude Code，就在您的终端旁边。
先决条件
安装
git clone https://github.com/jasonraz/cmux-browser-mcp.git
cd cmux-browser-mcp
chmod +x install.sh
./install.sh然后 重新启动克劳德代码.验证 /mcp --你应该看看 cmux-browser 上市的。
安装脚本将：
- 复制
server.mjs和package.json到~/.claude/mcp-servers/cmux-browser/ - 跑
npm install获取MCP SDK依赖关系 - 通过Claude Code注册服务器
claude mcp add
手动安装
如果你更喜欢自己做：
mkdir -p ~/.claude/mcp-servers/cmux-browser
cp package.json server.mjs ~/.claude/mcp-servers/cmux-browser/
cd ~/.claude/mcp-servers/cmux-browser && npm install
claude mcp add cmux-browser --scope user -- node ~/.claude/mcp-servers/cmux-browser/server.mjs工具（43）
| 类别 | 工具 |
|---|---|
| 导航 | browser_open, browser_open_split, browser_navigate, browser_back, browser_forward, browser_reload |
| 检查 | browser_snapshot, browser_screenshot, browser_get_url, browser_get |
| 交互 | browser_click, browser_fill, browser_type, browser_press, browser_hover, browser_select, browser_scroll, browser_check, browser_uncheck |
| 等待 | browser_wait |
| JavaScript | browser_eval |
| 搜索 | browser_find, browser_is |
| 调试 | browser_console, browser_errors, browser_highlight |
| 标签页 | browser_tab |
| 对话 | browser_dialog |
| 状态 | browser_cookies, browser_storage, browser_state |
| 下载 | browser_download |
| 注入 | browser_add_script, browser_add_init_script, browser_add_style |
| 框架 | browser_frame |
| 网络 | browser_network, browser_offline |
| 设备 | browser_viewport, browser_geolocation |
| 录制 | browser_screencast, browser_trace |
| 识别 | browser_identify |
工具说明
browser_click--支持action:click（默认），dblclick,focus,scroll-into-viewbrowser_press--支持action:press（默认），keydown,keyupbrowser_screenshot--接受可选--json标志通过json: truebrowser_tab—action接受new,list,switch,close，或数字选项卡索引
运作原理
服务器封装cmux browser CLI子命令作为MCP工具，具有适当的 模式。Claude Code在启动时发现了这些工具，并可以直接调用它们。
核心工作流程是 快照→ ref → act:
- 打开 一个页面
browser_open - 快照 可访问性树
browser_snapshot--返回元素
refs喜欢 [ref=e1], [ref=e2]
- 法案 关于元素：
browser_click参考e1,browser_fill参考e3带文本 - 验证 使用另一个快照或
browser_screenshot
截图
browser_screenshot 用途 cmux browser screenshot --out 捕捉a PNG直接到磁盘并返回文件路径。克劳德代码可以 Read 这 PNG可以直观地查看它。
配置
| 环境变量 | 默认值 | 描述 |
|---|---|---|
CMUX_CLI_PATH | /Applications/cmux.app/Contents/Resources/bin/cmux | cmux CLI二进制文件的路径 |
版本兼容性
工具检查cmux capabilities 运行时的端点。如果您调用一个需要比您安装的cmux版本更新的工具，您将收到一条明确的错误消息，告诉您缺少哪些功能，而不是一个神秘的故障。
v1.1.x中存在的所有工具都可以继续工作，不会发生任何变化。
陷阱
CMUX_SURFACE_IDenv 是：在cmux终端窗格中自动设置。MCP服务器
将其从子进程中删除，以便浏览器命令指向正确的曲面 而不是呼叫者的终端。这是自动处理的。
maxBuffer：服务器设置maxBuffer至50 MBexecFile呼吁
适应大的命令输出。
更新
git pull
./install.sh然后重新启动Claude Code。
卸载
claude mcp remove cmux-browser --scope user
rm -rf ~/.claude/mcp-servers/cmux-browser许可证
麻省理工学院