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ツール + 権限要求をすべてサポートし、安全なコマンドは自動的にバイパス
• Rate Limiter — Slack API呼び出しの集中制御 (トークンバケット + 429自動バックオフ)
• ダッシュボード — チームの進捗状況、エージェントの状態、Rate Limiterのメトリクスを視覚的なダッシュボードで表示
• ハートビート — エージェントの生存を監視し、無応答のエージェントを自動的に検出して通知
• DM + 予約メッセージ — 個人DM、予約送信、メッセージの固定
• インボックス検索 — FTS5全文検索でインボックスのメッセージを検索
• グレースフルシャットダウン — SIGINT/SIGTERM時に状態を自動的に保存 + Slack通知
• ファイル転送 — Slackでファイルをダウンロード/アップロード (画像、文書、ログなど)
• 長いメッセージの自動処理 — 分割送信またはファイルアップロード
• コストレポート — ccusageと連携してClaude Codeのトークン/コストをSlackで報告
• セッション復元 — compact/再起動後に状態を自動的に復元

📦 インストール

# 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

📚 ドキュメント

構成

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             #   集中型Rate Limiter (トークンバケット + 自動バックオフ)
│   ├── 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