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或更高版本。