mcp-session-bridge

Name: mcp-session-bridge
Author: t3ratech

本地服务

t3ratech.github.io浏览器自动化24 周前更新

代码仓库访问官网

关于 mcp-session-bridge

mcp-session-bridge 是用于浏览器会话自动化的 MCP 服务，可通过 T3rnel Browser 扩展或独立的持久化 CDP 浏览器运行。它面向需要读取已登录浏览器页面并操作页面、又不向远程浏览器发送会话 Cookie 的 MCP 客户端。

主要功能

01自动化操作已登录的浏览器标签页
02独立的持久化 CDP 浏览器模式
03返回页面上下文、表单、快照和截图
04通过本地中继转发扩展调用

适用场景

01检查已登录浏览器中的页面内容
02自动填写浏览器表单
03无需扩展运行浏览器自动化

MCP 相关

通过 stdio 提供 MCP 和 `session_*` 工具，可经由 T3rnel Browser 扩展转发请求，也可驱动独立的 CDP 浏览器。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "t3ratech-mcp-session-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@t3ratech/mcp-session-bridge"
      ],
      "env": {
        "T3RNEL_SESSION_MODE": "<T3RNEL_SESSION_MODE>",
        "T3RNEL_SESSION_HEADLESS": "<T3RNEL_SESSION_HEADLESS>",
        "T3RNEL_SESSION_TIMEOUT_MS": "<T3RNEL_SESSION_TIMEOUT_MS>"
      }
    }
  }
}

启动命令npx -y @t3ratech/mcp-session-bridge

需要配置的环境变量

T3RNEL_SESSION_MODEauto (default) uses the extension when its relay socket exists and falls back to a standalone browser; extension forces the extension; standalone forces its own browser.

T3RNEL_SESSION_HEADLESSSet to 1 to run the standalone browser headless. Ignored in extension mode.

T3RNEL_SESSION_TIMEOUT_MSHow long a single tool call may take before it fails rather than hanging the client.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@t3ratech/mcp-session-bridge1.2.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

MCP 会话桥接

一款免费的 MCP（Model Context Protocol）服务，可提供经过身份验证的浏览器会话自动化：session_* 工具可在用户自己的 Chrome 配置文件和真实登录会话中运行，这是云浏览器 API 无法做到的。还可免费使用独立模式；该模式会启动专用的自动化浏览器，无需扩展程序或许可证，同样可以使用 session_* 工具。

功能

通过标准输入/输出（以换行符分隔的 JSON-RPC）向任何支持 Model Context Protocol 的客户端提供 MCP 服务。设置指南涵盖常见客户端。
采用双传输设计：
- 扩展模式（免费；Pro 工具由扩展程序控制访问）——通过仅限所有者访问的本地中继套接字，将调用转发给 Chrome 启动的原生消息传递主机，再由主机转发至 T3rnel Browser 扩展程序；扩展程序会在实时身份验证标签页中执行这些调用。
- 独立模式（免费）——在持久化配置文件中启动自己的有头或无头 CDP 浏览器，并直接驱动它。无需许可证或扩展程序，也不会访问用户日常使用的浏览器。
返回结构化的页面上下文、表单值、页面快照和屏幕截图，不会将会话 Cookie 发送到远程浏览器。

价格

此桥接工具本身免费，本软件包也不会强制要求任何许可证。

扩展模式通过 T3rnel Browser 扩展程序访问买家的真实身份验证会话；它提供的 Pro 工具受该扩展程序自身的 Pro 级别限制——一次性支付 $29.99，可用于 3 台设备。独立模式免费，无需扩展程序或许可证。本软件包没有单独的订阅，也不会在此检查订阅；此文件早期版本曾宣传 $9/月和 $39/月的套餐，但这些套餐从未实现、从未强制执行，也从未开放购买。

项目结构

src/server.js — MCP 标准输入/输出服务：工具接口、架构验证、双传输路由、支持重连和超时的中继客户端，以及独立模式 CDP 启动器。
src/cdp.js — 独立模式 CDP 浏览器管理和 WebSocket 客户端。
src/native-host.js — 由 Chrome 启动的原生消息传递主机；负责管理中继套接字并复用并发 MCP 服务。
src/framing.js — 原生消息传递和中继套接字共用的 4 字节长度前缀 JSON 封帧。
src/tools.js — session_* 工具定义、验证，以及到扩展程序 browser_* 工具的映射。
src/license.js — 扩展程序和测试使用的离线 Ed25519 许可证验证辅助工具。
src/install.js — 为 Chrome、Chromium、Brave 和 Edge 注册原生主机的 --install / --uninstall。
docs/setup-guide.md — 在常见 MCP 客户端上的安装指南，以及验证和故障排除说明。
docs/chrome-validation-checklist.md — 使用 T3rnel Browser 扩展程序在 Chrome 上进行端到端验证的步骤。
ads/ — ad-copy.md，提交到 MCPize、Smithery、mcp.so 和 PulseMCP 时使用的通用标题与描述文案。
tests/ — node --test 测试套件，包括通过真实中继套接字和原生消息传递封帧进行的端到端测试，以及独立模式测试。

浏览器支持

扩展模式需要 T3rnel Browser 扩展，该扩展面向 Chrome、Brave、 Edge、Opera、Chromium 和 Firefox 打包，并通过各浏览器自己的扩展商店发布。Brave 和 Chromium 从 Chrome Web Store 安装；Edge、Opera 和 Firefox 则各自有独立的软件包。Opera 未实现侧边栏 API，Firefox 未实现调试器 API，因此两者仅获得部分支持；扩展的清单生成器会说明各浏览器缺少哪些功能。独立模式完全不需要浏览器——它会启动自己的 CDP 浏览器。

该扩展最多提供 100 个浏览器工具，此外还有桥接程序自己的 session_install 设置工具。如果合并后的列表超过 100 个工具——Google Antigravity 会拒绝安装这种列表—— 桥接程序就会移除价值最低的两个动词（session_md_diff、session_check_spelling），确保每个扩展构建版本发布的列表都不超过上限。被移除的工具仍可按名称调用并执行；所有工具仍受扩展的 Pro 限制和审批机制约束。