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许可证。