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 許可證。