All Agents MCP

所有代理MCP

⚠️ 已存档--此项目不再积极维护。 随着AI代理CLI生态系统的发展， 直接CLI调用+基于技能的集成 已经成为将代理CLIs包装在MCP服务器后面的更实用和主流的方法。 此项目的核心功能已合并到 强化克劳德码 作为技能。现在，通过以下方式可以更简洁、更可维护地实现相同的多代理编排 CLAUDE.md 配置和技能。 迁移指南： - 工具如 ask_agent, ask_all, delegate_task → 被强化claude代码中的技能所取代(/with, /web-fetch等等） - 无需设置MCP服务器——技能可以直接调用CLI - 环境变量模型配置→ 合并为陈述性 CLAUDE.md 设置

______________________________________________________________________

*下面的原始README供参考。*

______________________________________________________________________

一个MCP服务器，通过统一的界面协调多个AI CLI代理——Claude Code、Codex、Gemini CLI和Copilot CLI。委派任务，运行跨代理比较，并从任何兼容MCP的主机中利用每个代理的优势。

设计安全——没有OAuth令牌劫持

一些多代理工具通过从其他AI服务中提取OAuth令牌并直接调用其API来工作。这种方法（用于以下项目 OpenCode)违反了这些平台的服务条款，并可能导致 账户暂停或永久禁令.

所有代理mcp都采取了根本不同的方法。 它调用每个代理的 官方CLI二进制文件 (claude, codex, gemini, copilot)作为一个子进程，就像人类在终端中使用它们一样。不提取令牌，不在幕后调用API，也不绕过身份验证。

每个CLI代理都管理自己的身份验证、计费和速率限制。所有代理mcp只是一个流程编排器，它不会触及您的凭据。

特性

• 单代理查询 --问一个特定的代理人 ask_agent
• 多代理比较 --在所有代理中并行运行相同的提示符 ask_all
• 任务分配 --自动分析复杂性并路由到一个或多个代理
• 跨模型验证 --通过运行一个具有不同模型的代理来验证答案
• 专用工具 --代码审查、调试、解释、测试生成、重构
• 递归呼叫预防 --自动排除调用代理以避免无限循环
• 会话历史记录 --所有交互都可以通过MCP资源进行记录和查询
• 基于环境的模型配置 --在运行时通过以下方式覆盖模型 AA_MCP_* 环境变量

先决条件

• Node.js 22+
• 已安装并验证了以下CLI代理中的至少一个：

安装

克劳德代码

作为插件（推荐）

# 1. Add marketplace (includes all Dokkabei97 plugins)
/plugin marketplace add Dokkabei97/claude-plugins

# 2. Install plugin
/plugin install all-agents-mcp

您也可以直接添加插件存储库： /plugin marketplace add Dokkabei97/all-agents-mcp

这将所有代理mcp安装为Claude Code插件，为您提供：

• 8技能(/all-agents-mcp:ask, /all-agents-mcp:ask-all, /all-agents-mcp:delegate, /all-agents-mcp:review, /all-agents-mcp:debug, /all-agents-mcp:agents, /all-agents-mcp:aa-models, /all-agents-mcp:aa-fetch)
• 通过自动MCP服务器连接 npx
• 会话开始健康检查

作为MCP服务器

claude mcp add all-agents-mcp -- npx -y all-agents-mcp

或手动添加到 ~/.claude.json:

{
  "mcpServers": {
    "all-agents-mcp": {
      "command": "npx",
      "args": ["-y", "all-agents-mcp"]
    }
  }
}

Codex 命令行界面

codex mcp add all-agents-mcp -- npx -y all-agents-mcp

或手动添加到 ~/.codex/config.toml:

[mcp_servers.all-agents-mcp]
command = "npx"
args = ["-y", "all-agents-mcp"]

[mcp_servers.all-agents-mcp.env]
AA_MCP_LOG_LEVEL = "warn"

双子星命令行工具

gemini mcp add all-agents-mcp npx -y all-agents-mcp

或手动添加到 ~/.gemini/settings.json:

{
  "mcpServers": {
    "all-agents-mcp": {
      "command": "npx",
      "args": ["-y", "all-agents-mcp"]
    }
  }
}

副驾驶命令行界面

添加 ~/.copilot/mcp-config.json:

{
  "servers": [
    {
      "name": "all-agents-mcp",
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "all-agents-mcp"]
    }
  ]
}

源自源头

git clone https://github.com/Dokkabei97/all-agents-mcp.git
cd all-agents-mcp
npm install
npm run build

# Claude Code
claude mcp add all-agents-mcp -- node /path/to/all-agents-mcp/dist/index.js

# Codex
codex mcp add all-agents-mcp -- node /path/to/all-agents-mcp/dist/index.js

# Gemini CLI
gemini mcp add all-agents-mcp node /path/to/all-agents-mcp/dist/index.js

插件技能

当作为Claude Code插件安装时，可以使用以下技能：

技能

工具（14）

核心工具

验证

专用工具

网络工具

信息工具

资源（3）

使用示例

注册后，使用Claude Code中的自然语言：

# Ask a specific agent
"Ask Codex to implement a binary search function"

# Compare across agents
"Ask all agents how to optimize this SQL query"

# Delegate a task
"Delegate writing unit tests for src/utils/ to Gemini"

# Collaborate
"Collaborate with Copilot to review this architecture"

# Cross-model verification
"Verify with Copilot using gpt-5.2-codex, claude-sonnet-4.5, and gemini-3-pro-preview"

# Code review
"Ask Codex to review this code for security vulnerabilities"

# Debug
"Debug this TypeError with Gemini"

# Generate tests
"Generate vitest tests for this function using Codex"

# Check status
"Show me all available agents and their health"

模型配置

模型是通过环境变量配置的 AA_MCP_ 前缀。在MCP客户端配置中设置它们，以在运行时覆盖默认值：

{
  "mcpServers": {
    "all-agents-mcp": {
      "command": "npx",
      "args": ["-y", "all-agents-mcp"],
      "env": {
        "AA_MCP_CLAUDE_DEFAULT": "claude-sonnet-4.5",
        "AA_MCP_CODEX_ANALYSIS_LEVEL": "medium",
        "AA_MCP_GEMINI_MODELS": "gemini-2.5-pro,gemini-2.5-flash"
      }
    }
  }
}

可用环境变量

递归呼叫预防

当所有代理mcp在代理内运行时（例如，Claude Code调用所有代理mcp），它会自动检测调用者并将其从可用代理列表中排除。这可以防止无限的递归循环。

检测方法（按优先级顺序）：

1. CLI参数： --caller=claude
2. 环境变量： CLAUDECODE, CODEX_SANDBOX_TYPE, GEMINI_CLI, COPILOT_CLI
3. process.env._ 后备方案

开发方法学

该项目是按照以下步骤建造的 AIDE（Agent Informed Development Engineering）v1.0 --为agent时代设计的软件开发方法。应用的关键原则包括上下文预算约束、行为局部性、功能核心架构、测试即规范和确定性护栏。

测试状态

所有代理都经过测试和验证。

建筑

all-agents-mcp/
├── src/
│   ├── agents/          # Agent abstraction layer
│   │   ├── types.ts     #   IAgent interface, AgentResponse, HealthStatus
│   │   ├── base-agent.ts#   Abstract base with spawn logic
│   │   ├── claude-agent.ts
│   │   ├── codex-agent.ts
│   │   ├── gemini-agent.ts
│   │   ├── copilot-agent.ts
│   │   └── registry.ts  #   Detection, registration, recursion guard
│   │
│   ├── tools/           # 14 MCP tool definitions
│   ├── orchestrator/    # Parallel execution, complexity analysis, verification
│   ├── session/         # File-based session storage
│   ├── resources/       # 3 MCP resource definitions
│   ├── config/          # Env var config loader (AA_MCP_* overrides) + Zod schema
│   ├── utils/           # Logger (stderr), CLI detection
│   ├── server.ts        # McpServer factory
│   └── index.ts         # Entry point (stdio transport)

发展

npm install          # Install dependencies
npm run build        # Compile TypeScript
npm run dev          # Watch mode
npm run lint         # Biome lint + format
npm test             # Run tests

调试记录

AA_MCP_LOG_LEVEL=debug node dist/index.js

日志级别： debug, info （默认）， warn, error。所有日志都会转到stderr，以避免干扰MCP stdio传输。

许可证

麻省理工学院