使用说明

项目简介

Browser Tabs MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器应用,旨在为大型语言模型 (LLM) 客户端(如 Claude Desktop)提供访问和管理 Google Chrome 浏览器标签页的能力。通过此服务器,LLM 可以获取当前打开的 Chrome 标签页信息,并控制关闭指定的标签页,从而实现更丰富的浏览器交互功能。

主要功能点

  • 获取标签页列表: 检索所有打开的 Google Chrome 浏览器标签页的标题和 URL,并按窗口分组显示。
  • 关闭指定标签页: 根据窗口索引和标签页索引关闭 Google Chrome 中指定的标签页。

安装步骤

  1. 环境准备: 确保已安装 Node.js 18+、npm 和 Google Chrome 浏览器,并且操作系统为 macOS。
  2. 克隆仓库: 在终端中执行命令 'git clone https://github.com/kazuph/mcp-browser-tabs.git' 克隆仓库到本地。
  3. 进入目录: 执行 'cd mcp-browser-tabs' 进入项目目录。
  4. 安装依赖: 执行 'npm install' 安装项目依赖。
  5. 构建项目: 执行 'npm run build' 构建项目。
  6. 启用 Chrome 辅助功能:
    • 打开 “系统设置” (System Settings)。
    • 进入 “隐私与安全性” (Privacy & Security) -> “辅助功能” (Accessibility)。
    • 点击 “+” 按钮,从 “应用程序” (Applications) 文件夹中添加 “Google Chrome”。
    • 确保 Chrome 的开关处于 “开启” (ON) 状态。

服务器配置

对于 MCP 客户端(例如 Claude Desktop),您需要配置以下 JSON 对象以连接到 Browser Tabs MCP Server。将以下配置添加到您的 MCP 客户端配置文件中(例如 Claude Desktop 的 '~/Library/Application Support/Claude/claude_desktop_config.json'):

{
  "tools": {
    "browser-tabs": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-browser-tabs"]
    }
  }
}

配置参数说明:

  • 'command': 启动 MCP 服务器的命令。这里使用 'npx' 来运行 npm 包。
  • 'args': 传递给 'npx' 命令的参数。
    • '-y': 自动确认安装 npm 包,无需用户手动确认。
    • '@kazuph/mcp-browser-tabs': 指定要运行的 npm 包名称,即此 Browser Tabs MCP 服务器。

基本使用方法

配置完成后,MCP 客户端将能够自动连接并使用 Browser Tabs MCP Server 提供的工具。

  • 'get_tabs' 工具: 用于获取当前 Chrome 浏览器所有打开的标签页列表。LLM 客户端调用此工具后,服务器会返回包含标签页标题和 URL 的文本信息。
  • 'close_tab' 工具: 用于关闭指定的 Chrome 标签页。使用此工具时,需要提供 'windowIndex'(窗口索引,从1开始)和 'tabIndex'(标签页在窗口中的索引,从1开始)作为参数。例如,要关闭第一个窗口的第二个标签页,需要传递参数 '{"windowIndex": 1, "tabIndex": 2}'。

注意: 此服务器仅在 macOS 系统上可用,并且依赖于已安装的 Google Chrome 浏览器和已启用的辅助功能权限。

信息

分类

桌面与硬件