Superagent MCP

🚀 SuperAgent MCP

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

🚀 快速开始

SuperAgent作为一个MCP服务器，无缝连接支持MCP的客户端与多款强大的CLI代理，能让你高效并行执行任务，快速获取结构化结果。

✨ 主要特性

• 统一的代理运行器：无需额外包装，即可将Codex、Gemini和Continue CLI作为MCP工具公开。
• 并行执行：支持并发运行多个提示，具备每个任务的超时设置和基本的结果格式化功能。
• 代理库同步：提供现成的系统提示，安装到~/.superagent/agents目录，并且可以在本地进行扩展。
• 工具发现：通过查询内置的list-agents工具，可查看运行时可用的特定代理。

📦 安装指南

使用以下命令安装SuperAgent：

npm install @superclaude-org/superagent

安装后脚本会在~/.superagent/agents目录下创建缺失的代理定义文件，以便立即使用。

连接后，客户端将发现以下工具：

调用工具示例

{
  "tool": "codex",
  "arguments": {
    "concurrency": 2,
    "inputs": [
      { "prompt": "Run unit tests", "workingDirectory": "/path/to/app" },
      { "prompt": "Summarize latest git changes", "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或更高版本。