SuperAgent MCP

SuperAgent 是一个模型上下文协议（MCP）服务器，它连接了与 MCP 兼容的客户端与 Codex、Gemini 和 Continue CLI 代理。它允许你在并行中分发多个 CLI 任务，复用精心策划的系统提示，并将结果以单一结构化的响应返回给客户端。

主要功能

• 统一代理运行器：无需额外包装器即可将 Codex、Gemini 和 Continue CLIs 作为 MCP 工具公开。
• 并行执行：并发运行多个提示，并设置每个任务的超时时间和基本结果格式化。
• 代理库同步：提供预装的系统提示，安装到 ~/.superagent/agents 并可本地扩展。
• 工具发现：查询捆绑的 list-agents 工具以查看运行时可用的专用代理。

安装

npm install @superclaude-org/superagent

安装脚本会在 ~/.superagent/agents 下填充任何缺失的代理定义文件，以便它们立即可用。

一旦连接，客户端将发现这些工具：

工具	目的	显著参数
codex	并行运行一个或多个 Codex CLI 任务。	inputs[]（提示列表），concurrency，workingDirectory，agent，extraArgs，timeoutMs
gemini	运行带有自动批准功能的 Gemini CLI 任务。	inputs[]，concurrency，workingDirectory，agent，timeoutMs
continue	在无头模式下运行 Continue CLI 任务。需要 CONTINUE_CONFIG_PATH 环境变量。	inputs[]，concurrency，workingDirectory，agent，timeoutMs
list-agents	列出所有工具可用的专用代理。	(无)

调用工具

{
  "tool": "codex",
  "arguments": {
    "concurrency": 2,
    "inputs": [
      { "prompt": "运行单元测试", "workingDirectory": "/path/to/app" },
      { "prompt": "总结最新的git更改", "agent": "technical-writer" }
    ]
  }
}

代理管理

• 代理定义是带有前言的 Markdown 文件。你可以在 ~/.superagent/agents 中编辑或添加新文件。
• list-agents 工具显示每个代理的名称和描述，这样你就可以在调用 codex、gemini 或 continue 时提供 agent 字段。
• 包含的文件仅在不存在时复制，保留本地自定义。

Continue 配置

要使用 continue 工具，请设置 CONTINUE_CONFIG_PATH 环境变量指向你的 Continue 配置文件：

export CONTINUE_CONFIG_PATH="/path/to/.continue/config.yaml"

这可以在你的 MCP 客户端配置的 env 部分进行设置。

开发

npm install
npm run build
npm start   # 运行编译后的服务器
npm run dev # 使用 ts-node 运行 TypeScript 入口点

需要 Node.js 18 或更高版本。