ClawBridge MCP Server

关键词

桌面自动化任务管理引擎状态审计日志脚本化自动化

使用说明（Markdown格式）

  • 项目简介

    • ClawBridge MCP Server 是将 ClawBridge 的本地桌面与浏览器自动化能力对接到 MCP 协议的实现，使 MCP 客户端（如 Claude Code、Cursor 等）能够通过标准化的 JSON-RPC 调用读取任务、执行工具、获取资源等功能。

  • 主要功能点

    • MCP 服务端实现：提供基于 MCP 的工具、资源和配置接口，允许 LLM 客户端通过统一入口调用后端能力。
    • 工具注册与调用：通过 15 个 MCP 工具暴露任务执行、引擎状态、任务查询、记忆/配置等能力。
    • 资源与提示（Prompts）：支持获取与渲染系统提示、上下文信息和环境配置等内容，便于 LLM 进行对话式交互。
    • 会话与任务管理：通过 REST/WebSocket 提供任务创建、查询、暂停、取消、步骤查看等能力，具备审计日志与状态汇总。
    • 与 CLAUDE CODE/CURSOR 等对接：提供指令注册方式，支持通过 Claude Code 的 MCP 插件与 ClawBridge 后端通信。
    • 传输协议支持：实现 stdio 与 HTTP 两种传输，方便本地与远程客户端接入。

  • 安装步骤

    • 安装依赖
      • 需要 Python 环境，以及 MCP 客户端依赖：mcp（带 CLI 扩展）以及 httpx 等网络库。
    • 启动方式
      • stdio 传输（适用于本地 Claude Code 直接接入）:
        • python clawbridge_mcp.py
      • HTTP 传输（适用于远程客户端接入）:
        • python clawbridge_mcp.py --http
    • 客户端注册示例
      • 在 Claude Code 中注册对应的 MCP 服务：
        • claude mcp add clawbridge -- python clawbridge_mcp.py
      • 或使用 HTTP 传输的 URL 注册（需按客户端文档配置）。

  • 服务器配置（MCP 客户端需要的最小字段，JSON 格式，方便粘贴查看） { "server_name": "ClawBridge MCP Server", "start_command": "python", "start_args": ["clawbridge_mcp.py", "--http"], "description": "MCP 服务端暴露 ClawBridge 的任务、引擎、记忆和工作流能力", "registration_note": "客户端通过 claude mcp add clawbridge -- python clawbridge_mcp.py 进行注册，或使用 HTTP transport 的启动方式。" }

  • 基本使用方法

    • 启动后，MCP 客户端即可通过 JSON-RPC 请求调用诸如 run_task、get_task_status、list_tasks、list_engines 等工具，来提交任务、查询进度、获取引擎状态等。
    • 使用场景示例：
      • 获取可用引擎与状态：list_engines
      • 提交任务并等待结果：run_task（包含 prompt、engine、wait 选项）
      • 查询任务状态：get_task_status
      • 获取任务步骤与审计信息：get_task_steps、get_task_audit
    • 服务器与客户端的对接要点：
      • 客户端需要知道 MCP 服务器的 transport（stdio 或 HTTP）以及注册命令。
      • 客户端通过 MCP 的标准工具接口对 ClawBridge 的功能进行编排和查询。

  • 注意事项

    • MCP 服务器需要 ClawBridge 后端在本地运行，且监听 8765 端口（ClawBridge 的 REST API 地址）。
    • 安全性与权限：在生产环境中建议结合本地网络策略与认证机制，确保只被授权的 MCP 客户端访问。

服务器信息

访问项目