Browser Control MCP

浏览器控制MCP


MCP服务器与Firefox浏览器扩展配对，为AI助手提供对标签管理、浏览历史和网页文本内容的访问。

特性

MCP服务器支持以下工具：

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

示例用例：

选项卡管理

• *“关闭浏览器中所有与工作无关的选项卡。”*
• *“将浏览器中所有与开发相关的选项卡分组到一个名为“开发”的新组中。”*
• *“按照有意义的顺序重新排列浏览器中的选项卡。”*
• *“关闭浏览器中过去24小时内未访问过的所有选项卡”*

浏览器历史记录搜索

• *“帮我在浏览器历史记录中找到一篇关于新西兰米尔福德赛道的文章。”*
• *“打开我上周访问过的所有关于人工智能的文章，最多10篇，避免重复。”*

浏览和研究

• *“在我的浏览器中打开hackernews，然后打开头条新闻，阅读它，还阅读评论。评论与故事一致吗？”*
• *“在我的浏览器中，使用谷歌学术搜索过去3年中关于L-茶氨酸的论文。打开3篇被引用最多的论文。阅读并为我总结。”*
• *“在我的浏览器中使用谷歌搜索来查找花店。打开10个最相关的结果。向我显示每家花店的位置和营业时间。”*

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

MCP服务器和Firefox扩展组合的设计比web自动化MCP服务器更安全，使用户的个人浏览器更安全。

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

重要提示：浏览器控制MCP仍处于试验阶段。使用风险自负。您应该像对待任何其他MCP服务器一样谨慎行事，并仔细授权/监控工具调用。

安装

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

该插件的“管理扩展”页面将包含一个指向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. 类型 about:debugging 在Firefox URL栏中
2. 点击“此Firefox”
3. 点击“加载临时加载项…”
4. 选择 manifest.json 文件下 firefox-extension 此项目中的文件夹
5. 扩展程序的首选项页面将打开。将密钥复制到剪贴板。它将用于配置MCP服务器。

或者，要安装永久插件，您可以安装 插件.mozilla.org上的浏览器控制MCP 然后按照下面的详细说明配置MCP服务器。

如果您不想在个人Firefox浏览器上运行该扩展，另一种方法是下载单独的Firefox实例（如Firefox Developer Edition，可在https://www.mozilla.org/en-US/firefox/developer/).

MCP服务器配置

安装浏览器扩展后，将以下配置添加到mcpServers配置中（例如。 claude_desktop_config.json 克劳德桌面版）：

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

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

将EXTENSION_SECRET设置为Firefox中扩展首选项页面上显示的值（您可以在 about:addons).您还可以设置EXTENSION_PORT环境变量，以指定MCP服务器将用于与扩展通信的端口（默认为8089）。

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

使用Docker配置MCP服务器

或者，您可以使用基于Docker的配置。为此，构建mcp服务器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"
            ]
        }
    }
}