浏览器控制 MCP

一个与浏览器扩展配对的 MCP 服务器，使诸如 Claude Desktop 等 LLM 客户端能够控制用户的本地浏览器（Firefox）。

功能

MCP 服务器支持以下工具：

• 打开或关闭标签页
• 获取已打开标签页的列表
• 重新排列已打开的标签页
• 读取和搜索浏览器的历史记录
• 读取网页的文本内容和链接
• 在浏览器标签页中查找并高亮显示文本

此外，浏览器中每个已打开标签页的内容都作为 MCP 资源提供，允许用户在 MCP 客户端本身（例如 Claude）中选择浏览器标签页，并将其内容加载到上下文中。

示例用例：

标签页管理

• "关闭我浏览器中所有非工作相关的标签页。"
• "以合理的顺序重新排列我浏览器中的标签页。"
• "关闭我浏览器中在过去24小时内未被访问过的所有标签页。"

浏览器历史记录搜索

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

浏览和研究

• "在我的浏览器中打开 Hacker News，然后打开头条新闻，阅读它，同时阅读评论。评论是否同意文章的观点？"
• "在我的浏览器中使用 Google Scholar 搜索过去3年内关于L-茶氨酸的论文。打开引用最多的3篇论文。阅读它们并为我总结一下。"
• "在我的浏览器中使用谷歌搜索花店。打开最相关的10个结果。给我展示一个表格，列出每个花店的位置和营业时间。"

安装

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

npm install
npm install --prefix mcp-server
npm install --prefix firefox-extension
npm run build

最后的 npm run build 命令还将生成 MCP 服务器和扩展之间的共享密钥。

与 Claude Desktop 一起使用：

将以下配置添加到 claude_desktop_config.json 中（使用 Claude Desktop 开发者设置中的编辑配置按钮）：

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

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

确保重启 Claude Desktop。

与 Firefox 一起使用

浏览器控制 MCP 扩展是为 Firefox 开发的。

要安装扩展程序：

1. 在 Firefox 的地址栏中输入 about:debugging
2. 单击“此 Firefox”
3. 单击“加载临时附加组件...”
4. 选择此项目中 firefox-extension 文件夹下的 manifest.json 文件

如果您不想在个人 Firefox 浏览器上运行扩展程序，可以选择下载单独的 Firefox 实例（例如 Firefox Developer Edition，可在 https://www.mozilla.org/en-US/firefox/developer/ 下载）。