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