项目简介

SuperAgent MCP 是一个基于 Model Context Protocol (MCP) 的服务器实现。它旨在为支持MCP的客户端提供与 Codex 和 Gemini 命令行代理交互的能力。通过将这些CLI工具封装为MCP工具，SuperAgent 允许大型语言模型 (LLM) 客户端以标准化的方式调用它们，实现多任务并行执行，复用精心策划的系统提示（Agents），并将执行结果以结构化形式统一返回。

主要功能点

统一代理运行器: 无需额外包装即可将 Codex 和 Gemini 命令行工具暴露为MCP工具。
并行执行: 支持并发运行多个LLM任务，并为每个任务设置超时。
代理库同步: 自动安装预设的系统提示文件（Markdown格式），这些提示可供本地扩展和自定义。
工具发现: 提供 'list-agents' 工具，允许客户端查询当前可用的专业代理（即系统提示）及其功能。
会话管理与能力声明: 作为MCP服务器，它负责会话的建立、维护，并向连接的客户端声明其所提供的工具能力。

安装步骤

安装 Node.js: 确保您的系统已安装 Node.js 18 或更高版本。
安装 SuperAgent MCP: 通过 npm 包管理器安装 SuperAgent MCP 包：
```
npm install @superclaude-org/superagent
```
安装完成后，它会自动将预设的代理定义文件复制到您用户目录下的 '~/.superagent/agents' 文件夹中，以便服务器使用。

服务器配置

MCP客户端需要配置服务器的启动命令和参数以建立连接。以下是 SuperAgent MCP 服务器的典型配置信息，您可以在您的MCP客户端中添加此配置：

{
  "name": "SuperAgent",
  "command": "npm",
  "args": ["exec", "@superclaude-org/superagent"]
}

'name': 服务器的显示名称，您的MCP客户端会使用此名称来识别此服务器。
'command': 启动服务器的可执行文件或命令。此处使用 'npm' 命令来执行已安装的 'superagent' 包。
'args': 传递给启动命令的参数。'exec @superclaude-org/superagent' 指示 'npm' 执行 '@superclaude-org/superagent' 包中定义的主入口点。

基本使用方法

一旦您的MCP客户端与SuperAgent MCP服务器成功连接并配置，客户端将能够发现并调用以下工具来与AI代理交互：

'codex': 运行 Codex CLI 代理任务。

目的: 并行运行一个或多个Codex CLI任务。它支持多个输入，可以指定工作目录，并使用专业的“代理”（即预设的系统提示）。Codex 代理拥有完整的系统访问权限。

参数示例:

{
  "tool": "codex",
  "arguments": {
    "concurrency": 2,
    "inputs": [
      { "prompt": "运行应用程序的单元测试", "workingDirectory": "/path/to/my/app" },
      { "prompt": "总结最近的Git变更日志", "agent": "technical-writer" }
    ]
  }
}

'gemini': 运行 Gemini CLI 代理任务。

目的: 并行运行一个或多个Gemini CLI任务。与Codex类似，它支持多个输入、工作目录和专业的“代理”，并自动批准所有操作（“YOLO”模式）。