MCP Slack Agent Team

🚀 mcp-slack-agent-team

這是一個基於Slack的Claude Code遠程控制及多智能體團隊管理MCP服務器。可以在Slack頻道中向Claude Code智能體發送命令、接收結果，並協調多智能體團隊。

🚀 快速開始

# 1. 克隆項目並安裝依賴
git clone https://github.com/berrzebb/mcp-slack-agent-team.git
cd mcp-slack-agent-team/mcp-servers/slack
npm install
npm run build

# 2. 進行連接測試
cp .env.example .env
# 在.env文件中輸入SLACK_BOT_TOKEN和SLACK_DEFAULT_CHANNEL
npx tsx src/test.ts

註冊到Claude Code

在 .claude/settings.json 或 ~/.claude.json 中進行如下配置：

{
  "mcpServers": {
    "slack": {
      "command": "node",
      "args": ["path/to/mcp-slack-agent-team/mcp-servers/slack/dist/wrapper.js"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_DEFAULT_CHANNEL": "C채널ID"
      }
    }
  }
}

✨ 主要特性

• 遠程控制：在Slack中輸入命令，智能體執行並將結果以線程形式回覆。
• 命令循環：使用 slack_command_loop 完全替代聊天界面。
• 非阻塞檢查：通過 slack_command_loop(timeout=0) 和 slack_team_wait(timeout=0) 避免在工作時錯過Slack命令。
• 多智能體團隊：創建專用頻道，設置角色名稱和圖標，支持廣播和存檔。
• 智能體角色：提供12種命名角色（如Aria、Sage、Forge等），自動顯示角色專屬名稱和表情符號。
• @提及系統：使用角色名稱、角色和成員ID進行@提及，提及信息會存入隊列，等待接收者確認。
• 反應命令：將Slack表情符號反應（✅❌🚀🔄🗑️❓）自動轉換為命令。
• 後臺收集：每10秒自動輪詢消息，防止在不調用工具的情況下丟失Slack消息。
• 多進程安全：採用SQLite WAL、busy_timeout、輪詢器DB列表和按團隊單獨存儲。
• 永久上下文管理：基於SQLite存儲任務、決策和智能體上下文，壓縮上下文後可立即恢復。
• 熱重載：使用 slack_reload 進行代碼構建和服務器重啟，通過 wrapper.js 保持與Claude Code的連接。
• 通用審批鉤子：支持Bash命令、MCP工具和權限請求，自動繞過安全命令。
• 速率限制器：集中控制Slack API調用（令牌桶 + 429自動退避）。
• 儀表盤：以可視化儀表盤展示團隊進度、智能體狀態和速率限制器指標。
• 心跳監測：監測智能體存活狀態，自動檢測並通知無響應的智能體。
• DM和定時消息：支持個人DM、定時發送和消息固定。
• 收件箱搜索：使用FTS5全文搜索功能搜索收件箱消息。
• 優雅關閉：在接收到SIGINT/SIGTERM信號時自動保存狀態併發送Slack通知。
• 文件傳輸：支持在Slack中下載和上傳文件（如圖像、文檔、日誌等）。
• 長消息自動處理：自動分割發送或上傳文件。
• 成本報告：通過與ccusage集成，在Slack中報告Claude Code令牌和成本。
• 會話恢復：在壓縮或重啟後自動恢復狀態。

📦 安裝指南

# 1. 克隆項目並安裝依賴
git clone https://github.com/berrzebb/mcp-slack-agent-team.git
cd mcp-slack-agent-team/mcp-servers/slack
npm install
npm run build

# 2. 進行連接測試
cp .env.example .env
# 在.env文件中輸入SLACK_BOT_TOKEN和SLACK_DEFAULT_CHANNEL
npx tsx src/test.ts

💻 使用示例

基礎用法

# 克隆項目並安裝依賴
git clone https://github.com/berrzebb/mcp-slack-agent-team.git
cd mcp-slack-agent-team/mcp-servers/slack
npm install
npm run build

# 進行連接測試並配置環境變量
cp .env.example .env
# 在.env文件中輸入SLACK_BOT_TOKEN和SLACK_DEFAULT_CHANNEL
npx tsx src/test.ts

高級用法

{
  "mcpServers": {
    "slack": {
      "command": "node",
      "args": ["path/to/mcp-slack-agent-team/mcp-servers/slack/dist/wrapper.js"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_DEFAULT_CHANNEL": "C채널ID"
      }
    }
  }
}

📚 詳細文檔

項目結構

commands/                          # Claude Code斜槓命令
├── slack-loop.md                  #   /slack-loop — Slack命令等待循環
└── slack-team-resume.md           #   /slack-team-resume — 團隊會話恢復

mcp-servers/slack/                 # Slack MCP服務器
├── src/
│   ├── index.ts                   #   入口點 (工具註冊 + 服務器啟動)
│   ├── wrapper.ts                 #   自動重啟包裝器 (支持熱重載)
│   ├── background-poller.ts       #   後臺消息收集器 (每10秒一次)
│   ├── types.ts                   #   接口、常量、類型定義 + 智能體角色
│   ├── db.ts                      #   SQLite初始化 + 數據訪問助手
│   ├── state.ts                   #   基於SQLite的狀態管理 + 團隊註冊表
│   ├── slack-client.ts            #   WebClient + sendSmart + 消息分割
│   ├── formatting.ts              #   消息格式 + 富格式實用工具
│   ├── rate-limiter.ts             #   集中式速率限制器 (令牌桶 + 自動退避)
│   ├── approval-hook.ts           #   通用Slack審批鉤子 (Bash + 工具 + 權限)
│   ├── test.ts                    #   連接測試
│   ├── check.ts                   #   簡單連接檢查
│   └── tools/                     #   工具模塊 (共55個)
│       ├── basic.ts               #     基本通信 + 反應管理 + 診斷 (11個)
│       ├── content.ts             #     代碼/代碼片段上傳 (2個)
│       ├── loop.ts                #     命令循環 + 收件箱 + 反應命令 (3個)
│       ├── team.ts                #     團隊管理 + 提及 + 通知集成 (14個)
│       ├── context.ts             #     團隊上下文管理 + whoami (8個)
│       ├── approval.ts            #     審批請求 (1個)
│       ├── file.ts                #     文件下載/上傳 (2個)
│       ├── state.ts               #     狀態保存/恢復 + 成本報告 (3個)
│       └── dashboard.ts           #     儀表盤 + 心跳 + DM + 預約/權限 (11個)
├── package.json
├── tsconfig.json
└── .env.example

工作流程

用戶 (Slack)             智能體 (Claude Code)
    │                            │
    ├─── 輸入命令 ────────────→│  slack_command_loop
    │                            ├── 👀 確認接收
    │                            ├── 執行任務
    │                            ├── 發送結果 (線程)
    │←── 接收結果 ────────────┤  ✅ 完成
    ├─── 提供反饋 ──────────────→│  slack_wait_for_reply
    │                            └── 等待下一個命令

提供的工具 (55個)

所需的Slack Bot Token權限範圍

詳細設置指南：mcp-servers/slack/README.md

📄 許可證

本項目採用MIT許可證。