zen-devtools-mcp

zen-devtools-mcp

对 @mozilla/firefox-devtools-mcp 进行封装，使其连接到已经运行的基于 Firefox 的浏览器——Zen Browser、Firefox 或任何分支版本——而不是启动一个临时实例。

上游的 --connectExisting 模式要求浏览器启动时启用 Marionette。普通重启（点击 Dock 图标、运行 open -a Zen）不会启用它，因此无法连接。此封装解决了这个问题：如果 Marionette 尚未运行，它会正常退出浏览器（会话恢复会保留你的标签页），使用 --marionette 重新启动浏览器，等待端口就绪，然后启动 MCP。

安装 / 运行

无需安装——直接从 GitHub 运行：

npx github:sushruth/zen-devtools-mcp
bunx github:sushruth/zen-devtools-mcp

选项

标志	默认值	控制内容
--app	Zen	用于 open -a / 退出的 macOS 应用名称
--process	zen	用于 pgrep -x 的进程名称
--port	2828	用于探测和监听的 Marionette 端口

示例：

# Firefox instead of Zen
npx github:sushruth/zen-devtools-mcp --app Firefox --process firefox

# Zen with a custom Marionette port
npx github:sushruth/zen-devtools-mcp --port 2829

MCP 客户端配置

OpenCode 示例：

"zen-devtools": {
  "type": "local",
  "command": ["npx", "-y", "github:sushruth/zen-devtools-mcp"],
  "enabled": true
},
"firefox-devtools": {
  "type": "local",
  "command": ["npx", "-y", "github:sushruth/zen-devtools-mcp",
              "--app", "Firefox", "--process", "firefox", "--port", "2829"],
  "enabled": true
}

Claude Code（claude mcp add-json zen-devtools '<json>' 或 .mcp.json）：

"zen-devtools": {
  "command": "npx",
  "args": ["-y", "github:sushruth/zen-devtools-mcp"]
}

注意事项

• 会话恢复会在封装触发的重启后保留标签页。
• 无法在正在运行的浏览器进程中启用 Marionette——首次使用时必须重启。
• 仅适用于 macOS（open、osascript、pgrep）。
• 会向底层 MCP 传递 --connectExisting --enableScript；它会继承父进程的标准输入输出。