slackcli MCP

slackcli

  

对于AI，由AI。 Slack CLI和MCP服务器从头开始构建，用于LLM驱动的代理和编程访问。

为什么是slackcli？

大多数Slack工具都是为人类构建的。slackcli是为代理构建的。每一个设计决策——JSON优先输出、结构化错误代码、自动分页、速率限制重试——都是为了让LLM可以在不需要手动的情况下与Slack可靠地交互。将其作为MCP服务器插入，您的AI代理将获得Slack的超能力。使用 --read-only 当你需要护栏时，选择模式。

快速开始

1. 创建Slack应用程序 并使用所需的范围将其安装到您的工作区（例如。 channels:read, chat:write, search:read).
2. 获取Bot或用户OAuth令牌(xoxb-...)从 OAuth和权限.
3. 运行：

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

特性

• CLI命令 用于频道、消息、用户、文件、反应和搜索
• MCP服务器 （stdio传输）用于AI代理集成
• JSON第一个输出 针对LLM消费进行了优化，具有TTY感知表回退功能
• 费率限制处理 自动重试
• 错误分类 带有结构化错误代码
• 分页 支持所有列表操作
• 只读模式 防止AI代理意外写入

安装

自制：

brew install jackchuka/tap/slackcli

或者通过Go：

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

或者从源代码构建：

make build

认证

通过环境变量或CLI设置Slack令牌：

# Environment variable
export SLACK_TOKEN=xoxb-your-token

# Or use the auth command
slackcli auth login --token xoxb-your-token

# With a named workspace
slackcli auth login --token xoxb-your-token --name my-workspace

令牌解析顺序： --token 旗帜> SLACK_TOKEN env>存储的配置。

用法

命令行界面

# Channels
slackcli channels list
slackcli channels info C1234567890
slackcli channels create new-channel

# Messages
slackcli messages list --channel C1234567890
slackcli messages send --channel C1234567890 --text "Hello"
slackcli messages search --query "important"

# Users
slackcli users list
slackcli users info U1234567890

# Files
slackcli files list
slackcli files upload --channel C1234567890 --file ./report.pdf

# Reactions
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"
      }
    }
  }
}

可用的MCP工具：

只读模式

使用 --read-only 限制为只读操作。这可以防止AI代理意外发送消息、删除文件或修改频道。

命令行界面 --写入命令在执行前被拒绝：

slackcli --read-only channels list           # works
slackcli --read-only messages send ...       # blocked
# Error: command "slackcli messages send" is a write operation and cannot be used in read-only mode

MCP服务器 --编写工具完全隐藏（AI代理永远看不到它们）：

{
  "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.

输出格式

# Force JSON output
slackcli channels list -o json

# Force table output
slackcli channels list -o table

默认值：TTY为table，管道输出为JSON。

许可证

麻省理工学院