MMCPMarkets
JC

jasonraz/cmux-browser-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。 查看原文

11 stars 4 forks 质量 44 趋势 18
Repository Install

MCP server that gives Claude Code full control of cmux's embedded browser

概览

An MCP (Model Context Protocol) server that gives Claude Code full control of cmux's embedded browser. Open pages, click buttons, fill forms, take screenshots, run JavaScript — all from Claude Code, right next to your terminal. - cmux (macOS terminal with embedded browser) - Claude Code CLI (claude) - Node.js >= 18 Then . Verify with /mcp — you should see cmux-browser listed. The install script will: 1. Copy server.mjs and package.json to ~/.claude/mcp-servers/cmux-browser/ 2. Run npm install to fetch the MCP SDK dependency 3. Register the server with Claude Code via claude mcp add - — supports action: click (default), dblclick, focus, scroll-into-view - — supports action: press (default), keydown, keyup - — accepts optional --json flag via json: true - — action accepts new, list, switch, close, or a numeric tab index The server wraps cmux's browser CLI subcommands as MCP tools with proper schemas. Claude Code discovers these tools at startup and can call them directly. 1.

README

以下为原文 README 节选，完整内容请查看原文。

cmux-browser-mcp

An MCP (Model Context Protocol) server that gives Claude Code full control of cmux’s embedded browser.

Open pages, click buttons, fill forms, take screenshots, run JavaScript — all from Claude Code, right next to your terminal.

Prerequisites

  • cmux (macOS terminal with embedded browser)
  • Claude Code CLI (claude)
  • Node.js >= 18

Install

git clone https://github.com/jasonraz/cmux-browser-mcp.git
cd cmux-browser-mcp
chmod +x install.sh
./install.sh

Then restart Claude Code. Verify with /mcp — you should see cmux-browser listed.

The install script will:

  1. Copy server.mjs and package.json to ~/.claude/mcp-servers/cmux-browser/
  2. Run npm install to fetch the MCP SDK dependency
  3. Register the server with Claude Code via claude mcp add

Manual Install

If you prefer to do it yourself:

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

Tools (43)

Category Tools
Navigation browser_open, browser_open_split, browser_navigate, browser_back, browser_forward, browser_reload
Inspection browser_snapshot, browser_screenshot, browser_get_url, browser_get
Interaction browser_click, browser_fill, browser_type, browser_press, browser_hover, browser_select, browser_scroll, browser_check, browser_uncheck
Waiting browser_wait
JavaScript browser_eval
Search browser_find, browser_is
Debug browser_console, browser_errors, browser_highlight
Tabs browser_tab
Dialogs browser_dialog
State browser_cookies, browser_storage, browser_state
Downloads browser_download
Injection browser_add_script, browser_add_init_script, browser_add_style
Frames browser_frame
Network browser_network, browser_offline
Device browser_viewport, browser_geolocation
Recording browser_screencast, browser_trace
Identify browser_identify

Tool notes

  • browser_click — supports action: click (default), dblclick, focus, scroll-into-view
  • browser_press — supports action: press (default), keydown, keyup
  • browser_screenshot — accepts optional --json flag via json: true
  • browser_tab — action accepts new, list, switch, close, or a numeric tab index

How It Works

The server wraps cmux’s browser CLI subcommands as MCP tools with proper schemas. Claude Code discovers these tools at startup and can call them directly.

The core workflow is snapshot → ref → act:

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →