Agentic Tab Organizer MCP

将任何兼容 MCP 的 AI 代理连接到基于 Chromium 的浏览器中的实时标签页。该代理可以列出标签页、读取所选页面的内容、预览整理方案，并将保留的标签页合并到一个去重后的窗口中。

该整理器不包含 AI 模型，也不需要 AI API 密钥。你的 MCP 客户端使用其现有的模型认证。stdio 和独立的 HTTP 连接使用由扩展显示的本地配对令牌；该令牌绝不会离开你的机器。

功能

• 列出每个普通浏览器窗口中的标签页，包括标题、URL、标签组和标签页状态

• 从选定的 HTTP 和 HTTPS 标签页中提取有界可读文本

• 按精确域名或显式标签页 ID 关闭标签页，可选择子域名匹配

• 对规范化后完全相同的 URL 进行去重，同时保留首选副本

• 除非明确允许，否则在整理和任意关闭操作期间保留固定标签页

• 在更改浏览器之前预览并验证有序类别

• 创建一个带可见标签组的目标窗口，或一个扁平的从左到右标签栏

• 在关闭重复标签页之前对保留的标签页进行排序和验证

• 通过标准 MCP stdio 或本地 Streamable HTTP 连接

Related MCP server: ChromeWire MCP

要求

• Brave Browser、Google Chrome 或其他兼容的 Chromium 浏览器

• Node.js 20 或更高版本

• 兼容 MCP 的代理，如 OpenCode、Claude Desktop、Cursor 或其他 MCP 客户端

开发与真实浏览器验证主要在 Brave 上进行。Chrome 及相关 Chromium 浏览器使用相同的扩展 API，预期可以正常工作，但目前未获得同等的端到端覆盖。

构建

npx pnpm@11.24.0 install
npx pnpm@11.24.0 run build

在 Brave 中打开 brave://extensions，或在 Chrome 中打开 chrome://extensions，启用开发者模式，选择加载已解压的扩展程序，然后选择本仓库的 dist 目录。

打开扩展弹窗，复制其本地配对令牌。

连接代理

Stdio

Stdio 是最简单的选项。使用 dist-node/mcp-stdio.cjs 的绝对路径配置你的 MCP 客户端：

{
  "mcpServers": {
    "agentic-tabs": {
      "command": "/absolute/path/to/agentic-tab-organizer/dist-node/mcp-stdio.cjs",
      "env": {
        "AGENTIC_TABS_BRIDGE_TOKEN": "TOKEN_FROM_EXTENSION_POPUP"
      }
    }
  }
}

代理进程会打开一个仅限 localhost 的浏览器桥。扩展会自动重新连接。

Streamable HTTP

启动常驻的本地服务器：

AGENTIC_TABS_BRIDGE_TOKEN="TOKEN_FROM_EXTENSION_POPUP" npx pnpm@11.24.0 run mcp:http

将 MCP 客户端配置为使用：

http://127.0.0.1:32145/mcp

不要同时运行 stdio 和 HTTP 模式，因为两者使用相同的本地浏览器桥端口。

原生消息传递

原生消息传递在 macOS 和 Linux 上是可选的。安装程序会为 Google Chrome、Brave 和 Chromium 注册同一个主机：

npx pnpm@11.24.0 run install:host

重新加载扩展后，浏览器会自动启动本地 HTTP MCP 主机。将 HTTP MCP 客户端连接到 http://127.0.0.1:32145/mcp。

代理工作流

该 MCP 提供五个工具：

示例请求：

检查所有浏览器标签页。根据需要总结内容不明确的页面，将其分为工作、阅读、社交、开发和其他，然后预览方案。获得批准后，将它们合并到一个去重后的窗口中。

关闭来自 amazon.nl 的所有打开的标签页。

browser_plan_organization 接受 createGroups，默认为 true。将其设为 false 可仅将类别顺序用于从左到右的排列：固定标签页仍保持在最前面，随后按提供的顺序排列各个类别，目标窗口中没有可见的标签组。

将所有窗口合并为一个去重后的窗口。不要创建标签组；改为将类别从左到右排列。

安全与隐私

• 规划不会修改浏览器。

• 如果在规划后标签页、URL、窗口、固定状态、顺序或标签组发生了变化，应用操作将中止。

• 只有在目标窗口中验证了保留的标签页之后，才会关闭重复的标签页。

• browser_close_tabs 支持诸如 amazon.nl 之类的精确域名，或 browser_list_tabs 返回的显式 ID；开头的 www 会被规范化，子域名需要显式选择启用。

• 在关闭任何标签页之前，扩展会验证每个选定的标签页仍然具有 MCP 服务器所观察到的 URL。如果某个标签页在此期间发生了导航，整个关闭操作将中止。

• 固定标签页默认被跳过，并出现在 skippedTabs 中；关闭它们需要 allowPinned: true。

• 整理操作和任意关闭操作共享一个变更锁，防止它们并发地更改浏览器。

• 已禁用无痕模式访问。

• 本地 WebSocket 桥仅绑定到 127.0.0.1，并且只接受扩展的固定源。

• 扩展和本地 MCP 进程通过挑战-响应 HMAC 相互认证；配对令牌绝不会被传输。

• 仅当代理调用 browser_get_tab_content 时才返回页面内容。

• 受保护的浏览器页面（如 brave:// 和 chrome://）无法被读取，但仍可以被列出和移动。

• 返回给代理的内容可能会被发送到该代理所配置的模型提供商。

开发

npx pnpm@11.24.0 run typecheck
npx pnpm@11.24.0 run test:unit
npx pnpm@11.24.0 run test:integration
npx pnpm@11.24.0 run test:e2e
npx pnpm@11.24.0 run build

端到端测试套件使用一次性配置文件启动 Brave，绝不会触碰用户的正常浏览器配置文件。Brave 是主要验证的浏览器；Chrome 的兼容性源于共享的 Chromium 扩展 API 以及浏览器无关的集成路径。