Agents Council MCP

Agents Council

The simplest way to bridge and collaborate across AI Agent sessions

Status: Experimental

______________________________________________________________________

🏛️ 概述

专为已经拥有活动代理会话并希望他们在没有额外基础设施的情况下进行协作的开发人员而设计。

代理商委员会 是跨AI Agent会话进行桥接和协作的最简单方法，例如 克劳德代码, 法典, 双子座, 光标 或其他。它允许您的代理在不脱离当前环境的情况下，结合他们的优势来解决您最困难的任务。

使用该委员会的最有力方式是 连接您现有的活动会话。你可以用你想要的特定背景来初始化他们，让他们集思广益或同行评审此事，然后在理事会结束后无缝接管会议。

灵感来自Andrej Karpathy的 法学硕士理事会，它提供了一个基于MCP的CLI工具，允许多个代理相互通信，并为您最复杂的任务找到解决方案。

✨ 特性

• 集中式代理通信 通过MCP stdio服务器（无需复杂的对等网络）。
• 传唤克劳德或Codex：需要时，立即召集克劳德或Codex加入你的理事会。在可用的情况下重用本地CLI身份验证。
• 会话保存：根据您的具体情况启动代理，让他们协作，并在完成后继续。
• 人类参与：一个本地桌面议会大厅应用程序，用于监控或加入讨论。
• 私人和本地：状态存储在磁盘上 ~/.agents-council/state.json.
• 灵活性：Markdown或JSON文本输出，用于代理可读性或自动化。

______________________________________________________________________

🚀 入门指南

代理人委员会要求 或 包子.

1.MCP模式（零安装）

无需安装 当仅使用MCP模式时。您可以使用以下命令将代理委员会MCP服务器添加到您的代理中 npx （或 bunx).看 MCP设置 下面的部分提供了具体的命令。

如果您只需要代理之间的通信，请跳到MCP设置。仅为桌面应用程序和全局应用程序安装CLI council 命令。

2.桌面应用程序和CLI

如果您想通过桌面应用程序参与或使用 council 全局命令，安装软件包：

npm install -g agents-council

然后运行以下命令之一：

council        # desktop default launch
council chat   # compatibility alias: also launches desktop
council mcp    # terminal MCP server mode

3.分布模型

版本保持面向单个用户的npm包(agents-council)由平台可选依赖项支持：

• agents-council-linux-x64
• agents-council-linux-arm64
• agents-council-darwin-x64
• agents-council-darwin-arm64
• agents-council-windows-x64

每个平台包装运送：

• 这 council 终端模式的CLI二进制文件(--help, --version, mcp)，以及
• Electrobun桌面工件 desktop-artifacts/ 用于本地安装程序/更新分发。

GitHub发布了适用于macOS、Windows和Linux的Electrobun桌面可启动工件。

______________________________________________________________________

🔌 MCP设置

使用以下命令将委员会添加到您最喜欢的MCP客户端。

Claude Code Use the Claude Code CLI to add the Agents Council MCP server (guide):

claude mcp add council npx agents-council@latest mcp

或使用预定义的代理名称：

claude mcp add council -s user -- npx agents-council@latest mcp -n Opus

Gemini CLI Use the Gemini CLI to add the Agents Council MCP server (guide):

gemini mcp add council npx agents-council@latest mcp

Codex Use the Codex CLI to add the Agents Council MCP server (guide):

codex mcp add council npx agents-council@latest mcp

amp Use the amp CLI to add the Agents Council MCP server (guide):

amp mcp add council npx agents-council@latest mcp

Other MCP integrations

{
  "mcpServers": {
    "council": {
      "command": "npx",
      "args": [
        "agents-council@latest",
        "mcp"
      ]
    }
  }
}

______________________________________________________________________

📖 快速开始

1. 开始理事会会议 在一个终端中（例如通过Claude Code）描述您需要帮助的复杂主题。
2. 加入理事会 从另一个终端（例如通过Codex或Gemini）提供反馈。
3. 评审反馈 一旦理事会提供了足够的见解，就接管会议。

→

______________________________________________________________________

💬 桌面会议厅

为人类参与者运行本地桌面界面：

council

council chat 仍然可用作兼容性别名，并打开/聚焦相同的桌面界面。

桌面界面遵循了大会堂的重新设计：

• 议会侧边栏：会话历史记录、会话生成操作和存档区域。
• 议事厅：活动会话头、语音流、作曲家和召唤入口点。

召唤工作流是Hall界面的一部分。模型和代理选择将保持不变 ~/.agents-council/config.json.

UI实现和未来的UI功能工作应该遵循 docs/ui-spec.md 和 docs/ui-implementation-progress.md.

______________________________________________________________________

🪄 召唤特工

召唤功能允许您将克劳德或Codex特工带入正在进行的理事会大厅会议。被传唤的特工会审查此事和之前的反馈，然后将他们的回应贡献给同一个语音流。

召唤克劳德

先决条件：

• 克劳德代码 必须在PATH中安装并可用
• 跑 claude 至少进行一次身份验证

它是如何工作的：

1. 一名被传唤的克劳德特工加入了正在进行的委员会会议
2. 它读取当前请求和任何先前的反馈
3. 它使用理事会工具做出回应
4. 代理被授予对项目（read/Glob/Grep）以及理事会工具的只读访问权限
5. 其他工具遵循您的Claude Code用户权限设置

高级配置：

这些设置是可选的。默认情况下，代理人委员会会寻找 claude 在你的路径。

召唤法典

先决条件：

• 跑 codex login 一次（身份验证由Codex SDK/CLI处理）
• 可选：在中设置默认模型 ~/.codex/config.toml （例如， model = "gpt-5.2-codex")

它是如何工作的：

1. 被传唤的食品法典委员会特工阅读当前的请求和任何先前的反馈
2. 它返回一个记录在理事会中的单一响应
3. 默认情况下，Codex通过Codex SDK CLI以只读模式运行

高级配置：

身份验证由Codex SDK/CLI处理（通常 codex login).如果您的Codex设置使用API密钥或自定义基本URL，这些密钥仍将得到遵守。

这些设置是可选的。默认情况下，代理委员会使用SDK中捆绑的Codex CLI。

______________________________________________________________________

🛠️ MCP工具

• start_council：使用请求打开新会话（返回 session_id).
• join_council：通过以下方式加入特定会话 session_id.
• get_current_session_data：投票特定 session_id （支持游标）。
• send_response：向特定人员提交反馈 session_id.
• close_council：结束特定 session_id 并得出结论。
• summon_agent：召集克劳德或Codex进入现任理事会。

______________________________________________________________________

🗺️ 路线图

未检查的项目是有计划的，可能会根据反馈而改变。

• \[x\] v0.1-MCP委员会
• \[x\] v0.2-聊天界面
• \[x\] v0.3-召唤克劳德
• \[x\] v0.4-召唤法典
• \[\]v0.5-召唤双子座
• \[\]v0.6-并行举行多个理事会会议
• \[\]v0.7-通过API密钥连接到外部LLM
• \[\]v0.8-代理可以召唤用户（Telegram/Slack）

______________________________________________________________________

📄 许可证

麻省理工学院