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

服务器信息