使用说明

项目简介

Browser Control MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务器，配合浏览器扩展程序使用。它旨在为大型语言模型 (LLM) 客户端（如 Claude Desktop）提供控制用户本地浏览器的能力。通过此服务器，LLM 可以执行诸如打开/关闭标签页、读取标签页列表、访问浏览历史记录以及获取网页内容等操作，从而实现更丰富的交互和任务自动化。

主要功能点

标签页管理: 支持 LLM 客户端打开、关闭浏览器标签页。
浏览历史访问: 允许 LLM 客户端查询和获取用户的浏览历史记录。
网页内容获取: 提供工具让 LLM 客户端读取指定标签页的文本内容和链接信息。
资源管理: 以结构化资源的形式向 LLM 客户端提供浏览器状态和数据（例如，当前打开的标签页列表、网页内容等）。
工具注册与执行: 注册并执行浏览器控制工具，响应来自 LLM 客户端的工具调用请求。
WebSocket 通信: 使用 WebSocket 协议与浏览器扩展程序进行实时通信。
Stdio 传输: 通过标准输入/输出 (stdio) 与 MCP 客户端（如 Claude Desktop）进行通信。

安装步骤

克隆仓库: 首先，将 GitHub 仓库 'browser-control-mcp' 克隆到本地。

git clone https://github.com/eyalzh/browser-control-mcp.git
cd browser-control-mcp

安装依赖: 在仓库根目录以及 'mcp-server' 和 'firefox-extension' 目录下分别运行 'npm install' 命令安装项目依赖。

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

构建项目: 运行 'npm run build' 命令构建 MCP 服务器和浏览器扩展程序。
```
npm run build
```

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude Desktop）配合使用，您需要配置客户端以连接到此服务器。以 Claude Desktop 为例，您需要在 'claude_desktop_config.json' 文件中添加如下配置信息。

Claude Desktop 配置 (claude_desktop_config.json):

{
    "mcpServers": {
        "browser-control": {  // 服务器名称，可以自定义
            "command": "node",  // 启动服务器的命令，这里使用 Node.js 运行 JavaScript
            "args": [
                "<仓库路径>/mcp-server/dist/server.js"  // 服务器入口文件路径，请替换为实际的仓库路径
            ]
        }
    }
}

注意:

请将 '<仓库路径>' 替换为您克隆 'browser-control-mcp' 仓库的实际本地路径。
配置完成后，请重启 Claude Desktop 使配置生效。

基本使用方法

安装 Firefox 扩展:
- 打开 Firefox 浏览器，访问 'about:debugging'。
- 在左侧菜单中选择 "This Firefox"。
- 点击 "Load Temporary Add-on..." 按钮。
- 在文件选择框中，导航到 '<仓库路径>/firefox-extension' 目录，并选择 'manifest.json' 文件。
- 扩展程序将被临时安装到 Firefox 浏览器中。
启动 MCP 服务器:
- 打开终端，进入 '<仓库路径>/mcp-server' 目录。
- 运行命令 'node dist/server.js' 启动 MCP 服务器。
- 服务器成功启动后，会在控制台输出 "MCP Server running on stdio" 和 "Browser API initialized on port 端口号" 等信息。
与 LLM 客户端交互:
- 配置并启动支持 MCP 协议的 LLM 客户端（如 Claude Desktop）。
- LLM 客户端将通过 stdio 与 MCP 服务器通信。
- 您可以使用自然语言指令指示 LLM 客户端使用浏览器控制功能，例如：
  - “关闭我浏览器中所有非工作相关的标签页。”
  - “在我的浏览器历史记录中查找关于新西兰 Milford Track 的文章。”
  - “在浏览器中打开 Hacker News，然后打开头条新闻，阅读内容和评论。评论是否与文章观点一致？”
  - “在我的浏览器中使用 Google Scholar 搜索过去 3 年关于 L-茶氨酸的论文。打开引用次数最多的 3 篇。”

安全提示:

由于此扩展程序会暴露您的浏览历史记录和浏览器操作权限给 MCP 客户端，建议在单独的 Firefox 实例（例如 Firefox Developer Edition）上安装此扩展，而不是您的个人常用浏览器。

关键词