Slack MCP Server

Slack MCP Server

site icon
2025.04.20 38474
JavaScriptSlack API团队协作消息管理交流协作
Slack MCP Server 是一个用于 Slack API 的 MCP 服务器,使 Claude 能够与 Slack 工作区进行交互。它提供了多种工具来管理频道、发送消息、回复线程、添加表情反应以及获取用户信息等功能。
View on GitHub

Overview

基本能力

产品定位

Slack MCP Server 是一个用于 Slack API 的 MCP 服务器,使 Claude 能够与 Slack 工作区进行交互。

核心功能

  1. 频道管理:列出公共或预定义频道,获取频道历史消息。
  2. 消息管理:发送消息到频道,回复特定消息线程。
  3. 表情反应:添加表情反应到消息。
  4. 用户管理:获取工作区用户列表和详细用户信息。

适用场景

  1. 团队协作:自动化消息发送和回复,提高团队沟通效率。
  2. 用户管理:快速获取用户信息,便于团队管理。
  3. 频道监控:获取频道历史消息,便于分析和监控。

工具列表

  1. slack_list_channels:列出公共或预定义频道。
  2. slack_post_message:发送消息到指定频道。
  3. slack_reply_to_thread:回复特定消息线程。
  4. slack_add_reaction:添加表情反应到消息。
  5. slack_get_channel_history:获取频道历史消息。
  6. slack_get_thread_replies:获取线程回复。
  7. slack_get_users:获取工作区用户列表。
  8. slack_get_user_profile:获取详细用户信息。

常见问题解答

  1. 权限错误:确保所有必需的权限范围已添加到 Slack 应用。
  2. 安装问题:确保应用已正确安装到工作区。
  3. 配置问题:确保令牌和工作区 ID 已正确复制到配置中。
  4. 频道访问:确保应用已添加到需要访问的频道。

使用教程

使用依赖

  1. 创建一个 Slack 应用:访问 Slack Apps 页面
  2. 配置 Bot Token 范围:添加以下范围:
  3. channels:history
  4. channels:read
  5. chat:write
  6. reactions:write
  7. users:read
  8. users.profile:read
  9. 安装应用到工作区:保存 "Bot User OAuth Token"(以 xoxb- 开头)。
  10. 获取 Team ID(以 T 开头)。

安装教程

使用 npx

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_TEAM_ID": "T01234567",
        "SLACK_CHANNEL_IDS": "C01234567, C76543210"
      }
    }
  }
}

使用 docker

{
  "mcpServers": {
    "slack": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SLACK_BOT_TOKEN",
        "-e",
        "SLACK_TEAM_ID",
        "-e",
        "SLACK_CHANNEL_IDS",
        "mcp/slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_TEAM_ID": "T01234567",
        "SLACK_CHANNEL_IDS": "C01234567, C76543210"
      }
    }
  }
}

调试方式

  1. 确保所有环境变量已正确设置。
  2. 检查 Slack 应用的权限范围是否正确配置。
  3. 验证应用是否已安装到工作区。
  4. 确保应用已添加到需要访问的频道。

构建

Docker 构建:

docker build -t mcp/slack -f src/slack/Dockerfile .

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。