Slackcli

🚀 slackcli

由AI打造，為AI服務。 slackcli是專門為大語言模型驅動的智能體和程序化訪問而從頭構建的Slack命令行界面（CLI）和多命令處理器（MCP）服務器。它能讓智能體可靠地與Slack交互，無需人工干預。

🚀 快速開始

1. 創建一個Slack應用，並將其安裝到你的工作區，同時選擇所需的權限範圍（例如channels:read、chat:write、search:read）。
2. 從OAuth & Permissions中獲取機器人或用戶的OAuth令牌（xoxb-...）。
3. 運行以下命令：

brew install jackchuka/tap/slackcli
export SLACK_TOKEN=xoxb-your-token
slackcli channels list

✨ 主要特性

• 豐富的CLI命令：支持對頻道、消息、用戶、文件、反應和搜索等操作。
• MCP服務器：通過標準輸入輸出傳輸，方便與AI智能體集成。
• JSON優先輸出：優化了大語言模型的消費體驗，在終端環境下會自動回退為表格形式。
• 智能限流處理：遇到限流時會自動重試。
• 錯誤分類：提供結構化的錯誤代碼，便於排查問題。
• 分頁支持：所有列表操作都支持分頁功能。
• 只讀模式：防止AI智能體意外寫入數據。

📦 安裝指南

使用Homebrew安裝

brew install jackchuka/tap/slackcli

通過Go安裝

go install github.com/jackchuka/slackcli/cmd/slackcli@latest

從源代碼構建

make build

💻 使用示例

CLI使用示例

# 頻道操作
slackcli channels list
slackcli channels info C1234567890
slackcli channels create new-channel

# 消息操作
slackcli messages list --channel C1234567890
slackcli messages send --channel C1234567890 --text "Hello"
slackcli messages search --query "important"

# 用戶操作
slackcli users list
slackcli users info U1234567890

# 文件操作
slackcli files list
slackcli files upload --channel C1234567890 --file ./report.pdf

# 反應操作
slackcli reactions add --channel C1234567890 --timestamp 1234567890.123456 --name thumbsup
slackcli reactions list --user U1234567890

MCP服務器使用示例

啟動MCP服務器以集成AI智能體：

slackcli mcp serve

在你的MCP客戶端（例如Claude Desktop）中進行配置：

{
  "mcpServers": {
    "slack": {
      "command": "slackcli",
      "args": ["mcp", "serve"],
      "env": {
        "SLACK_TOKEN": "xoxb-your-token"
      }
    }
  }
}

只讀模式使用示例

使用--read-only參數限制為只讀操作，防止AI智能體意外發送消息、刪除文件或修改頻道。

CLI只讀模式

slackcli --read-only channels list           # 正常工作
slackcli --read-only messages send ...       # 操作被阻止
# 錯誤信息：命令 "slackcli messages send" 是寫操作，不能在只讀模式下使用

MCP服務器只讀模式

{
  "mcpServers": {
    "slack-readonly": {
      "command": "slackcli",
      "args": ["--read-only", "mcp", "serve"],
      "env": {
        "SLACK_TOKEN": "xoxb-your-token"
      }
    }
  }
}

只讀工具（始終可用）：auth_test、list_channels、get_channel_info、list_messages、list_users、get_user_info、get_user_presence、list_reactions、list_files、get_file_info、search_messages。 寫工具（在只讀模式下隱藏）：create_channel、archive_channel、invite_to_channel、kick_from_channel、set_channel_topic、set_channel_purpose、send_message、edit_message、delete_message、add_reaction、remove_reaction、delete_file。

輸出格式示例

# 強制輸出JSON格式
slackcli channels list -o json

# 強制輸出表格格式
slackcli channels list -o table

默認情況下，在終端環境下輸出表格格式，在管道輸出時輸出JSON格式。

📄 許可證

本項目採用MIT許可證。