Browser Control MCP

浏览器控制 MCP

一个与 Firefox 浏览器扩展配套的 MCP 服务，可让 AI 助手访问标签页管理、浏览历史记录和网页文本内容。

功能

MCP 服务支持以下工具：

• 打开或关闭标签页
• 获取已打开标签页列表
• 创建带名称和颜色的标签页组
• 重新排列已打开的标签页
• 读取和搜索浏览器历史记录
• 读取网页的文本内容和链接（需要用户同意）
• 在浏览器标签页中查找并突出显示文本（需要用户同意）
• 截取标签页可见区域的屏幕截图（每个标签页都需要用户同意）

使用场景示例：

标签页管理

• “关闭浏览器中所有与工作无关的标签页。”
• “将浏览器中所有与开发相关的标签页分组到一个名为 ‘Development’ 的新组中。”
• “按合理的顺序重新排列浏览器中的标签页。”
• “关闭浏览器中所有过去 24 小时内未访问过的标签页。”

浏览器历史记录搜索

• “帮我在浏览器历史记录中找一篇关于新西兰 Milford Track 的文章。”
• “打开过去一周访问过的所有关于 AI 的文章，最多 10 篇，并避免重复。”

浏览与研究

• “在浏览器中打开 hackernews，然后打开头条故事并阅读，还要阅读评论。这些评论是否赞同该故事？”
• “在浏览器中使用 Google Scholar 搜索过去 3 年关于 L-theanine 的论文。打开被引用次数最多的 3 篇论文。阅读并为我总结。”
• “在浏览器中使用 Google 搜索查找花店。打开最相关的 10 个结果。用表格列出每家花店的位置和营业时间。”

与网页自动化 MCP 服务的比较

MCP 服务与 Firefox 扩展的组合旨在比网页自动化 MCP 服务更安全，让用户能够更安全地使用自己的个人浏览器。

• 它不支持修改网页、与页面交互或执行任意脚本。
• 读取网页内容需要用户在浏览器中针对每个域名明确同意。此限制由扩展的 manifest 层强制执行。
• 截取屏幕截图需要用户点击扩展的工具栏按钮，授权每个单独的标签页。扩展依赖 activeTab 权限来实现此功能，因此授权由 Firefox 本身强制执行，并会在标签页跳转或关闭时失效。扩展不会为截图请求广泛的主机权限。
• 它使用 MCP 服务与扩展之间共享密钥的本地连接。
• 不会远程收集数据或进行跟踪。
• 它提供扩展端审计日志，用于记录工具调用以及工具启用/禁用配置。
• 扩展不包含运行时第三方依赖项。

重要提示：Browser Control MCP 仍处于实验阶段。使用风险自负。与使用其他 MCP 服务一样，请谨慎操作，并仔细授权/监控工具调用。

安装

选项 1：安装 Firefox 和 Claude Desktop 扩展

Firefox 扩展/附加组件可在 addons.mozilla.org 获取。你也可以从此 GitHub 仓库下载并打开最新的预构建版本：browser-control-mcp-1.5.0.xpi。按照安装后自动打开的“管理扩展”页面中的说明完成安装。

附加组件的“管理扩展”页面中会提供 Claude Desktop DXT 文件的链接。你也可以在此处下载：mcp-server-v1.5.2.dxt。下载文件后，打开该文件，或将其拖入 Claude Desktop 的设置窗口。安装后，请确保启用 DXT 扩展。此功能仅适用于最新版本的 Claude Desktop。如果你想在本地安装 MCP 服务，请参阅下方的 MCP 配置。

选项 2：从代码构建

若要从代码构建，请克隆此仓库，然后在仓库主目录中运行以下命令，以构建 MCP 服务和浏览器扩展。

npm install
npm run build

安装 Firefox 临时附加组件

若要在 Firefox 中安装临时附加组件：

1. 在 Firefox 地址栏中输入 about:debugging
2. 点击“This Firefox”
3. 点击“Load Temporary Add-on...”
4. 在此项目的 firefox-extension 文件夹中选择 manifest.json 文件
5. 扩展的首选项页面会打开。将密钥复制到剪贴板，用于配置 MCP 服务。

或者，若要安装永久附加组件，你可以安装 addons.mozilla.org 上的 Browser Control MCP，然后按照下方所述配置 MCP 服务。

如果你不想在个人 Firefox 浏览器中运行扩展，也可以下载一个单独的 Firefox 实例（例如 Firefox Developer Edition，可从 https://www.mozilla.org/en-US/firefox/developer/ 获取）。

MCP 服务配置

安装浏览器扩展后，将以下配置添加到 mcpServers 配置中（例如，Claude Desktop 的 claude_desktop_config.json）：

{
    "mcpServers": {
        "browser-control": {
            "command": "node",
            "args": [
                "/path/to/repo/mcp-server/dist/server.js"
            ],
            "env": {
                "EXTENSION_SECRET": "<secret_on_firefox_extension_options_page>",
                "EXTENSION_PORT": "8089" 
            }
        }
    }
}

将 /path/to/repo 替换为正确的路径。

将 EXTENSION_SECRET 设置为 Firefox 扩展首选项页面中显示的值（可通过 about:addons 访问）。你也可以设置 EXTENSION_PORT 环境变量，以指定 MCP 服务用于与扩展通信的端口（默认值为 8089）。

MCP 服务可能需要几秒钟才能连接到扩展。

使用 Docker 配置 MCP 服务

或者，你可以使用基于 Docker 的配置。为此，请构建 mcp-server Docker 镜像：

docker build -t browser-control-mcp .

并使用以下 mcpServers 配置：

{
    "mcpServers": {
        "browser-control": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-p", "127.0.0.1:8089:8089",
                "-e", "EXTENSION_SECRET=<secret_from_extension>",
                "-e", "CONTAINERIZED=true",
                "browser-control-mcp"
            ]
        }
    }
}