mcp-supersubagents

关键词

并行代理资源管理JSON-RPC工具执行模板渲染

使用说明（Markdown）

项目简介

mcp-supersubagents 是一个基于 Model Context Protocol (MCP) 的后端服务器实现。它向 MCP 客户端提供统一的上下文服务，包括托管资源、注册并执行工具、以及定义和渲染提示模板。服务器通过 JSON-RPC 与客户端通信，处理任务创建、执行、取消、获取任务详情等操作，并提供系统状态、任务列表等资源的订阅能力。核心目标是为大语言模型客户端（LLM）提供安全、可扩展的上下文服务框架。

主要功能点

  • MCP 核心能力
    • 提供 MCP 服务器的核心接口：工具列表、调用工具、读取任务、读取资源、订阅资源等。
    • 支持任务管理、资源订阅、任务结果的分页读取等 MCP 原生能力。
  • 资源、工具与任务管理
    • 资源：系统状态、全部任务、单个任务、任务会话日志等数据显示和订阅。
    • 工具：8 个 MCP 工具（5 个专用启动工具、3 个通用工具），用于启动子代理、读取/写入、以及与任务会话互动。
    • 任务：任务生命周期管理、依赖关系、超时、轮转与重试、以及任务结果输出。
  • 工具执行模板与协同
    • 提供基于模板的代理执行（ coder/planner/researcher/tester/general），每个工具有明确的输入约束和工作流。
    • 任务间依赖与自动完成/自启动，支持并行执行与自动回退（多账户轮换、跨提供者切换）。
  • 模板与模型管理
    • 模型注册与解析、提供模型别名、动态可用模型、提供对不同提供者的模型翻译。
    • 规划器优先模型、编码器默认模型等策略。
  • 多账户轮换与容错
    • 针对 Copilot、Codex、Claude 等提供者实现了多账户轮换、容量限制、以及熔断/限流处理。
  • 可观测性与容错
    • 任务与会话的指标、配额、工具调用统计、子代理（Subagent）状态等指标可观测。
    • 针对断点恢复、会话中断、以及异常情况有多层兜底处理。

安装与运行

  • 依赖和构建
    • 克隆仓库 -> 安装依赖 -> 构建 -> 启动服务器。
    • 在开发/测试阶段，常见流程为安装依赖、构建、启动服务器。
  • 服务器启动
    • 服务器以 STDIO 传输为默认运输实现，通过 JSON-RPC 与 MCP 客户端通信。
    • 服务器启动后可通过 MCP 客户端进行资源订阅、任务创建与工具调用等交互。

服务器配置（MCP 客户端使用信息，配置示例以 JSON 形式给出说明）

服务器名称：super-agents 命令与参数示例（客户端配置示意，非代码块，仅作注释性说明） { "serverName": "super-agents", "command": "pnpm", "args": ["start"], "env": { "GITHUB_PAT_TOKENS": "ghp_token1,ghp_token2", "OPENAI_API_KEY": "", // 如使用 Codex/Codex 相关提供者，请提供相应的 API Key（可选） "CODEX_MODEL": "gpt-5.4-high" // 如需使用 Codex，提供默认模型 } } 注释说明

  • serverName：MCP 客户端在 MCP 服务端识别的名称。
  • command/args：启动服务器所需的可执行命令及参数。客户端需要使用该信息来启动 MCP 服务器进程，连接到 MCP 服务端。
  • env：服务器运行所需的环境变量，例如多账户令牌配置、模型与 API 访问设置等。
  • MCP 客户端对该配置仅需要读取并按需启动服务器进程，不需要在 MCP 客户端实现代码中包含服务器实现细节。

基本使用方法

  • 启动与注册
    • 在服务器所在环境执行配置命令，启动 MCP 服务器进程。
    • 服务器启动后，客户端可通过 MCP 的 JSON-RPC 请求获取工具列表、创建任务、读取任务状态、读取资源、订阅资源等。
  • 任务与资源交互
    • 使用 MCP 请求创建任务、设置依赖、提供 context_files、选择模型等。
    • 通过 ListTasks、GetTask、GetTaskPayload 等接口获取任务状态与输出。
    • 使用 ReadResource、ListResources、Subscribe/Unsubscribe 来获取系统状态、任务列表以及单任务详情。
  • 观察与诊断
    • 通过系统状态、任务总览、以及输出日志了解当前执行进度。
    • 关注任务的输出文件、日志的分段输出，以及工具调用的摘要信息。

运行时特性与注意事项

  • 多提供者协作与回退
    • 支持 Codex、Copilot、Claude 等提供者的并行执行与回退策略。
    • 当某个提供者不可用或发生错误时，自动切换到链中的下一个可用提供者。
  • 模型与翻译
    • 支持将通用模型名映射到各自提供者的内部模型表示，确保跨提供者正确路由。
  • 安全与稳定性
    • 针对中断、超时、错误、回退等场景均有健壮的处理逻辑，确保 MCP 服务端在异常情况下仍然能正确回收资源。
  • 传输与接口
    • 当前实现以 STDIO 为传输，官方 MCP 允许多种传输协议，仓库实现中以 STDIO 为核心传输路径，方便嵌入式或 CLI 客户端接入。

<keywords>并行代理, 资源管理, JSON-RPC, 工具执行, 模板渲染</keywords> <category_id>6</category_id>

服务器信息

访问项目