Browser Control MCP

一个与 Firefox 浏览器插件配对的 MCP 服务器，提供给 AI 助手访问标签管理、浏览历史和网页文本内容的功能。

特性

该 MCP 服务器支持以下工具：

• 打开或关闭标签页
• 获取已打开标签页列表
• 创建带有名称和颜色的标签组
• 重新排序已打开的标签页
• 查阅和搜索浏览器的历史记录
• 阅读网页的文本内容和链接（需要用户同意）
• 在浏览器标签中查找并高亮显示文本（需要用户同意）

示例用例：

标签管理

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

浏览历史搜索

• "帮我找到我浏览器历史记录中关于新西兰米尔福德赛道的文章。"
• "打开我在过去一周内访问过的关于AI的文章，最多10篇，避免重复。"

浏览和研究

• "在浏览器中打开 Hacker News，然后打开头条新闻，阅读它，也阅读评论。评论是否与故事一致？"
• "在我的浏览器中使用 Google 学术搜索过去三年关于 L-茶氨酸的论文。打开引用最多的三篇论文，阅读并总结给我。"
• "使用我的浏览器中的 Google 搜索查找花店。打开最相关的10个结果。展示每个花店的位置和营业时间的表格。"

与 Web 自动化 MCP 服务器的比较

该 MCP 服务器和 Firefox 插件组合设计得比 Web 自动化 MCP 服务器更安全，允许用户在个人浏览器中更安全地使用。

• 它不支持网页修改、页面交互或任意脚本。
• 阅读网页内容需要用户在浏览器中针对每个域明确同意。此限制在插件清单级别强制执行。
• 它使用仅限本地连接，并且 MCP 服务器和插件之间共享密钥。
• 不进行远程数据收集或跟踪。
• 它提供了插件端的审计日志，用于工具调用和工具启用/禁用配置。
• 插件不包含运行时第三方依赖项。

重要提示：Browser Control MCP 目前仍处于实验阶段。请自行承担风险使用。应像对待任何其他 MCP 服务器一样谨慎操作，并仔细授权/监控工具调用。

安装

更新：由于 MCP 启动问题，当前 MCP 服务器无法与 Claude Desktop 兼容。

方案 1：安装 Firefox 和 Claude Desktop 插件

Firefox 插件/附加组件可在 addons.mozilla.org 下载。您也可以从这个 GitHub 仓库下载最新预构建版本：browser-control-mcp-1.5.0.xpi。根据“管理扩展”页面上的说明完成安装，该页面会在安装后自动打开。

附加组件的“管理扩展”页面将包括一个指向 Claude Desktop DXT 文件的链接。您也可以在这里下载：mcp-server-v1.5.1.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. 点击 "加载临时附加组件..."
4. 选择此项目下 firefox-extension 文件夹中的 manifest.json 文件
5. 扩展程序的偏好设置页面将打开。复制密钥到剪贴板。它将在配置 MCP 服务器时使用。

或者，要安装永久附加组件，您可以从 addons.mozilla.org 安装 Browser Control MCP，然后按照下面的详细步骤配置 MCP 服务器。

如果您不想在个人 Firefox 浏览器上运行扩展程序，可以选择下载单独的 Firefox 实例（例如 Firefox 开发者版，可在 https://www.mozilla.org/zh-CN/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": "<来自Firefox扩展选项页面的密钥>",
                "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=<来自扩展的密钥>",
                "-e", "CONTAINERIZED=true",
                "browser-control-mcp"
            ]
        }
    }
}