JinDaGe - browser-control-mcp MCP Details

article

README

🚀 浏览器控制 MCP

浏览器控制 MCP 是一个与浏览器扩展配对的 MCP 服务器，它能让大语言模型客户端（像 Claude Desktop 这类）对用户本地的 Firefox 浏览器进行控制，极大地提升了用户与浏览器交互的便捷性和智能化程度。

✨ 主要特性

此 MCP 服务器具备丰富的功能，支持以下实用工具：

可灵活地打开或关闭浏览器标签页，让您轻松管理浏览窗口。
能够获取已打开的标签页列表，方便您快速定位所需页面。
支持重新排列已打开的标签页，使您的浏览界面更加有序。
可以查看和搜索浏览器历史记录，帮助您快速找到之前浏览过的内容。
能够读取网页正文内容及链接，为您提供全面的网页信息。
可在浏览器标签页中查找并高亮文本，便于您快速定位关键信息。

此外，每个已打开的标签页在浏览器中的内容均可作为 MCP 资源使用。这意味着用户能在 MCP 客户端（如 Claude）中直接选择浏览器标签页，并加载其内容，实现更加高效的信息获取。

📦 安装指南

构建 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": [
                "<路径>/mcp-server/dist/server.js"
            ]
        }
    }
}

请将<路径>替换为正确的路径，然后记得重新启动 Claude Desktop。

与 Firefox 一起使用

浏览器控制 MCP 扩展是针对 Firefox 开发的。要安装该扩展，可按以下步骤操作：

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

如果您不希望在个人 Firefox 浏览器上运行扩展，可以选择下载单独的 Firefox 实例（例如 Firefox 开发者版，访问地址：https://www.mozilla.org/en-US/firefox/developer/）。

💻 使用示例

标签页管理

"关闭所有非工作相关的标签页。"
"将我的标签页按有意义的方式重新排列。"
"关闭 24 小时内未访问过的标签页。"

浏览器历史搜索

"帮我找到一篇关于新西兰米尔福德小径的文章。"
"打开过去一周我浏览的所有关于 AI 的文章，最多显示 10 篇，避免重复。"

浏览与研究

"在浏览器中打开 Hackernews，然后打开头条新闻并阅读文章及其评论。评论是否普遍认同这篇文章？"
"使用 Google Scholar 在浏览器中搜索过去三年关于 L - 茶氨酸的论文。打开被引用最多的三篇论文。阅读后进行摘要。"
"使用谷歌搜索引擎查找花店。打开最相关的 10 个结果。展示每个花店及其位置和营业时间的表格。"

browser-control-mcp