Claudezilla MCP 服务器

关键词

浏览器自动化本地服务JSON-RPCFirefox 原生扩展无网络通信

使用说明（Markdown 格式）

  • 项目简介

    • Claudezilla MCP 服务器是一个完整的 MCP 服务端实现，负责暴露工具集合、资源访问与提示相关能力，供 MCP 客户端通过 JSON-RPC 进行调用。
    • 服务器通过一个本地 Unix 套接字与原生主机通信，提供对 Firefox 的浏览器自动化能力，并对多代理/多会话场景进行会话管理与权限控制。

  • 主要功能点

    • MCP 核心能力
      • ListTools：返回可用工具清单，支持根据扩展权限动态过滤（如 private 窗口模式下禁用导航等）。
      • CallTool：执行具体工具调用，将客户端参数转换为对本地原生主机的请求，返回结构化的结果或错误信息。
    • 资源与工具管理
      • 通过工具集合管理浏览器控制、开发者工具、页面分析、循环/聚焦等能力。
      • 支持标签/拥有者（ownerId）机制，确保跨代理的安全性与隔离。
    • 会话与心跳
      • 为每个 agent 维护心跳，定期清理孤儿代理并清理相关标签/标签页。
    • 异常与诊断
      • 提供对连接、授权、扩展版本与标签池状态的诊断能力，并对常见错误给出人类可读的错误信息。
    • 传输和扩展性
      • 设计可在多种传输协议之上工作，当前实现通过 stdio 传输，底层通过本地套接字进行与原生主机的通信。

  • 安装与运行步骤

    • 运行环境要求
      • Node.js 18 及以上
    • 启动方式（示例，实际路径以项目结构为准）
      • 使用 Node 启动 MCP 服务器入口脚本（入口通常放在 mcp/server.js）
    • 运行要点
      • MCP 服务器监听本地 Unix 套接字作为与原生主机通信的通道，同时通过 STDIO 传输与 MCP 客户端通信。
      • 服务器在启动时会读取宿主进程创建的授权令牌文件，用于与扩展原生主机的绑定认证。

  • 服务器配置（MCP 客户端所需仅用于建立连接的配置信息，以下为示例配置要点说明） 注：MCP 客户端需要的配置信息仅包含服务器标识、启动命令与参数即可，客户端本身不需要修改服务器代码。以下描述旨在帮助理解正确的连接配置含义。

    • server_name（服务器名称）
    • command（启动命令）
    • args（启动参数）
    • transport（传输方式，默认采用 stdio，亦可扩展为 SSE/WebSocket 等）
    • 其他路径与权限信息（由服务器内部管理，客户端无需关心）

    配置要点说明（非代码，仅作为理解文本）：

    • server_name: claudezilla
    • command: node
    • args: ["mcp/server.js"]
    • transport: stdio
    • 说明: 客户端通过指定 server_name 与启动命令及参数即可与 MCP 服务器建立连接；服务器会在本地完成与原生主机的通信并暴露 MCP 工具集。

  • 基本使用方法

    • 客户端向 MCP 服务器发起请求（通过 JSON-RPC）
    • 获取工具列表、选择工具、按需传入参数执行，并获取返回结果
    • 通过会话管理实现多代理场景下的标签页/窗口资源分配与隔离
    • 当计划重启或关闭服务器时，服务器会进行清理工作，确保已创建的标签页与会话被正确处理

  • 运行与调试提示

    • 初次运行时，请确保原生主机进程已经就绪，授权令牌文件正确创建，并且套接字路径可用
    • 如遇导航权限或私有模式相关的安全检查，请参考服务器实现中的权限过滤逻辑
    • 日志与诊断输出可帮助快速定位连接、权限、以及标签池的状态

关键词 浏览器自动化, 本地服务, JSON-RPC, Firefox 原生扩展, 无网络通信

分类ID 5

服务器信息

访问项目