Agents Council

🚀 Agents Council

Agents Council 是连接并实现多个 AI 智能体会话协作的最简方案，旨在帮助开发者在无需额外基础设施的情况下，让现有的智能体会话相互协作，共同解决复杂任务。

🚀 快速开始

Agents Council 需要 Node.js 或 Bun 环境。

1. MCP 模式（零安装）

仅使用 MCP 模式时，无需安装。你可以使用 npx（或 bunx）将 Agents Council MCP 服务器添加到你的智能体中。具体命令请参考下面的 MCP 配置 部分。

如果你只需要智能体之间的通信，可直接跳至 MCP 配置。仅在需要使用 Web 界面或全局 council 命令时，才安装 CLI。

2. 网页界面与 CLI

如果你想通过网页界面参与或使用全局 council 命令，请安装该软件包：

npm install -g agents-council

然后运行 council chat 在浏览器中启动本地网页界面。

✨ 主要特性

• 集中式智能体通信：通过 MCP stdio 服务器实现（无需复杂的点对点网络）。
• 召唤 Claude：在需要时，可立即将新的 Claude 实例召唤到你的智能体议会中。复用你本地的 Claude Code 认证信息。
• 会话保存：使用特定上下文启动智能体，让它们协作，并在完成后恢复会话。
• 人类参与：提供本地聊天界面，用于监控或参与讨论。
• 私密与本地：状态信息存储在磁盘的 ~/.agents-council/state.json 文件中。
• 灵活性：支持 Markdown 或 JSON 文本输出，方便智能体读取或自动化处理。

📦 安装指南

MCP 配置

Claude Code

使用 Claude Code CLI 添加 Agents Council MCP 服务器（指南）：

claude mcp add council npx agents-council@latest mcp

或使用预定义的智能体名称：

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

Gemini CLI

使用 Gemini CLI 添加 Agents Council MCP 服务器（指南）：

gemini mcp add council npx agents-council@latest mcp

Codex

使用 Codex CLI 添加 Agents Council MCP 服务器（指南）：

codex mcp add council npx agents-council@latest mcp

amp

使用 amp CLI 添加 Agents Council MCP 服务器（指南）：

amp mcp add council npx agents-council@latest mcp

其他 MCP 集成

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

📚 详细文档

快速上手

1. 启动智能体议会会话：在一个终端（例如通过 Claude Code）中启动议会会话，并描述你需要帮助解决的复杂问题。
2. 加入议会：从另一个终端（例如通过 Codex 或 Gemini）加入议会，提供反馈。
3. 审查反馈：在议会提供足够的见解后，审查反馈并接管会话。

聊天界面

运行供人类参与者使用的本地网页界面：

council chat

聊天界面运行在 localhost 上，允许你实时监控会话。它还支持将 Claude 智能体 召唤 到活跃的议会中。召唤模态框允许你选择智能体/模型，选择结果会保存在 ~/.agents-council/config.json 中。

召唤 Claude

召唤功能允许你将新的 Claude 智能体引入议会会话。该智能体将加入讨论，审查问题和先前的反馈，然后提供自己的响应。

前提条件

• 必须安装 Claude Code 并将其添加到系统路径中。
• 至少运行一次 claude 进行认证。

工作原理

1. 被召唤的 Claude 智能体加入活跃的议会会话。
2. 它读取当前请求和任何先前的反馈。
3. 它使用议会工具提供响应。
4. 该智能体被授予对项目的只读访问权限（读取/全局搜索/ grep）以及议会工具。
5. 其他工具遵循你的 Claude Code 用户权限设置。

高级配置

这些设置是可选的。默认情况下，Agents Council 会在系统路径中查找 claude。

MCP 工具

• start_council：使用请求开启一个会话。
• join_council：为首次参与者获取请求和响应。
• get_current_session_data：轮询新的响应（支持游标）。
• send_response：提交反馈。
• close_council：以结论结束会话。
• summon_agent：将 Claude 召唤到当前议会中。

路线图

未勾选的项目为计划中的功能，可能会根据反馈进行调整。

• [x] v0.1 - MCP 议会
• [x] v0.2 - 聊天界面
• [x] v0.3 - 召唤 Claude
• [ ] v0.4 - 召唤 Codex
• [ ] v0.5 - 召唤 Gemini
• [ ] v0.6 - 并行多个议会会话
• [ ] v0.7 - 通过 API 密钥连接到外部大语言模型
• [ ] v0.8 - 智能体召唤用户（Telegram/Slack）

📄 许可证

本项目采用 MIT 许可证。