使用说明
项目简介
Browser Tabs MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器应用,旨在为大型语言模型 (LLM) 客户端(如 Claude Desktop)提供访问和管理 Google Chrome 浏览器标签页的能力。通过此服务器,LLM 可以获取当前打开的 Chrome 标签页信息,并控制关闭指定的标签页,从而实现更丰富的浏览器交互功能。
主要功能点
- 获取标签页列表: 检索所有打开的 Google Chrome 浏览器标签页的标题和 URL,并按窗口分组显示。
- 关闭指定标签页: 根据窗口索引和标签页索引关闭 Google Chrome 中指定的标签页。
安装步骤
- 环境准备: 确保已安装 Node.js 18+、npm 和 Google Chrome 浏览器,并且操作系统为 macOS。
- 克隆仓库: 在终端中执行命令 'git clone https://github.com/kazuph/mcp-browser-tabs.git' 克隆仓库到本地。
- 进入目录: 执行 'cd mcp-browser-tabs' 进入项目目录。
- 安装依赖: 执行 'npm install' 安装项目依赖。
- 构建项目: 执行 'npm run build' 构建项目。
- 启用 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 浏览器和已启用的辅助功能权限。
信息
分类
桌面与硬件