TabOrg MCP Server
使用说明(Markdown 便捷版本)
-
项目简介 TabOrg MCP Server 是一个本地 MCP 服务器实现,部署在浏览器扩展环境中,旨在通过标准化的 MCP 协议向 LLM 客户端暴露浏览器标签、分组、窗口等资源,以及一组可调用的工具与提示模板。它支持资源读取、工具执行、Prompts 获取与渲染,并通过 JSON-RPC 与客户端通信,提供会话管理和跨传输协议(如 HTTP/SSE、WebSocket)的能力。
-
主要功能点
- 资源管理与读取
- 提供对浏览器当前打开的标签、分组、窗口等资源的统一访问接口。
- 工具注册与执行
- 能注册用于控制浏览器行为的工具,并通过 JSON-RPC 调用执行,返回结果给客户端。
- Prompt 定义与获取
- 允许注册并获取可用于与 LLM 交互的提示模板与对话内容。
- 会话管理与能力声明
- 服务器维护会话状态、连接状态、能力声明等,确保客户端按需订阅与调用。
- 多传输支持
- 通过 HTTP + SSE 的传输,以及 WebSocket 的桥接,为不同客户端提供灵活的连接方式。
- 安全与扩展性
- 设计为可扩展的后端框架,确保对资源、工具、Prompts 的安全访问与可扩展能力。
- 资源管理与读取
-
安装步骤
- 环境准备
- 需要 Node.js(推荐版本在文档/仓库要求范围内)以及 Yarn。
- 安装依赖
- 在仓库根目录执行安装命令,安装服务器端所需的依赖。
- 启动 MCP Bridge Server
- 使用仓库提供的工作区命令启动服务器,例如:yarn workspace @taborg/server start。
- 启用 MCP 服务端
- 在 TabOrg 扩展设置中开启“Enable MCP Server”,并确认连接状态为 Connected。
- 客户端连接示例配置(JSON 描述,供 MCP 客户端配置使用)
- 服务器名称:taborg
- 启动命令:npx
- 参数:-y mcp-proxy http://localhost:3000/mcp
- 说明:上述配置用于将本地 MCP 服务器暴露的 http://localhost:3000/default/mcp(实例默识别为 default)路径提供给 MCP 客户端连接。请按客户端要求将实例 ID 替换为实际的实例标识(例如 default)。
- 备注
- MCP 客户端的具体使用配置可能因实现而异,请结合客户端文档完成对接。
- 环境准备
-
服务器配置(对 MCP 客户端的连接信息描述,非源代码)
- serverName: "taborg"
- command: "npx"
- args: ["-y", "mcp-proxy", "http://localhost:3000/mcp"]
- 说明:该配置使客户端通过 HTTP 端点 http://localhost:3000/mcp(默认实例为 default,具体实例名可替换)与服务器建立 MCP 通信。
-
基本使用方法
- 连接阶段
- 启动服务器后,确保 MCP 客户端建立对应的连接,服务器将对客户端进行能力宣布与资源、工具、提示的通知。
- 调用资源与工具
- 客户端可通过 MCP 请求读取资源、执行工具、获取提示,并获取对应的 JSON-RPC 响应。
- 会话与订阅
- 服务器支持会话初始化、订阅资源更新、工具变更等通知,客户端可通过相应的 JSON-RPC 方法进行订阅与处理。
- 安全性与扩展
- 如需进一步的安全控制和扩展,请参考仓库中的实现结构,集成鉴权、细粒度权限和日志。
- 连接阶段
-
额外注意
- MCP 的核心协议与实现细节在服务端代码中已覆盖:对请求的处理、响应的重写/路由、通知的发送、以及对 SSE/WebSocket 传输的支持等。
- 若要自建开发环境,请确保按照仓库的开发指南安装并运行服务器,以及按扩展/客户端要求配置连接路径与实例。
关键词(3-5 个,用逗号分隔) Model Context Protocol, JSON-RPC, 本地服务, 浏览器标签管理, LLM 集成
分类ID 6