slamy (Tackeyy)

slamy--Slack MCP服务器和CLI

日本语

懒散 MCP（模型上下文协议） 服务器也可以作为独立的CLI工作。将像Claude这样的AI代理连接到您的Slack工作区，或直接从终端使用它。

特性

• MCP服务器 --将Slack操作作为人工智能代理（Claude Code、Claude Desktop等）的MCP工具公开
• 命令行界面 --直接从终端使用相同的操作
• 频道 --列出频道，检索消息历史记录
• 消息 --发布消息，回复帖子
• 用户 --列出工作区成员，查看配置文件
• 反应 -在消息中添加表情符号反应
• 搜索 --使用Slack查询语法跨渠道搜索消息
• 多种输出格式 --人类可读文本、JSON和TSV

安装

家酿

brew install tackeyy/tap/slamy

去

go install github.com/tackeyy/slamy@latest

从源代码构建

git clone https://github.com/tackeyy/slamy.git
cd slamy
go build -o slamy .

快速开始

1.创建Slack应用程序

1. 首选 松弛API 然后单击 创建新应用程序
2. 选择 从头开始，命名您的应用程序（例如。， slamy)
3. 选择要安装到的工作区

2.配置用户令牌范围

在 OAuth和权限 > 范围 > 用户令牌范围，添加：

3.安装和设置环境变量

将应用程序安装到您的工作区，然后设置您的令牌：

export SLACK_USER_TOKEN=xoxp-your-user-token

4.跑步

./slamy channels list

用户令牌与机器人令牌

Slack Apps可以发行两种类型的代币。使用哪一个取决于你的用例。

在以下情况下使用用户令牌：代表用户行事

slamy是作为 人工智能秘书/个人助理 （Claude Code+MCP）代表特定用户读取、搜索和发布到Slack。在这种情况下，用户令牌是自然的选择：

1. 搜索需要它 — search:read 是仅限用户令牌的作用域。机器人令牌根本无法搜索消息
2. 单一代币 --无需管理两个令牌，也不必担心哪个操作使用哪个令牌
3. 用户上下文 --代理发布的消息显示为用户，明确了谁负责
4. 通道接入 --代理可以访问与用户相同的频道，而无需手动邀请

在构建机器人时使用机器人令牌

如果您正在构建Slack机器人（而不是个人助理），Bot Token是正确的选择：

• 机器人有自己的身份，并以“应用程序名称”发布帖子，而不是以特定用户的身份发布
• 多个用户与机器人交互——它不应该像任何单个用户一样
• 您希望通过仅邀请机器人访问特定频道来控制访问
• 您不需要邮件搜索，或者可以接受限制

命令

channels list --列出频道

slamy channels list [--limit ] [--include-archived] [--json] [--plain]

channels history --获取频道消息历史记录

slamy channels history  [--limit ] [--json] [--plain]

messages post --发布消息

slamy messages post  --text  [--json] [--plain]

messages reply --回复一个帖子

slamy messages reply   --text  [--broadcast] [--json] [--plain]

users list --列出工作区用户

slamy users list [--include-deactivated] [--include-bots] [--json] [--plain]

users profile --获取用户资料

slamy users profile  [--json] [--plain]

reactions add -添加表情符号反应

slamy reactions add   --name  [--json] [--plain]

search messages --搜索邮件

slamy search messages  [--count ] [--page ] [--sort ] [--sort-dir ] [--json] [--plain]

auth test --测试身份验证

slamy auth test [--json] [--plain]

mcp --启动MCP服务器

slamy mcp

通过stdio启动MCP服务器，将所有操作作为AI代理的工具（例如Claude Code）公开。

配置

环境变量

输出格式

文本（默认）

#general                       C01234ABCDE  [42 members]
#random                        C01234FGHIJ (private)  [15 members]

JSON(--json)

[
  {
    "id": "C01234ABCDE",
    "name": "general",
    "num_members": 42,
    "is_private": false
  }
]

TSV(--plain)

C01234ABCDE	general	42	public
C01234FGHIJ	random	15	private

MCP服务器

使用Claude代码

claude mcp add slamy /path/to/slamy mcp

使用Claude Desktop

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "slamy": {
      "command": "/path/to/slamy",
      "args": ["mcp"],
      "env": {
        "SLACK_USER_TOKEN": "xoxp-your-user-token"
      }
    }
  }
}

可用工具

发展

# Build
go build -o slamy .

# Run all tests with race detector
go test -race ./...

# Run tests with coverage
go test -cover ./...

看 贡献.md 用于开发设置和编码标准。 看 docs/TEST.md 获取全面的测试指南。

贡献

欢迎投稿！请阅读我们的 贡献指南 在提交Pull Request之前。

所有贡献者都应该遵循我们的 行为准则.

许可证

麻省理工学院

链接

• Slack API文档
• 模型上下文协议