Slack User MCP Server

Slack User MCP Server

site icon
2025.02.09 3
JavaScriptSlack API消息管理用户管理交流协作
Slack User MCP Server 是一个用于 Slack API 的 MCP 服务器,使 Claude 能够以用户身份与 Slack 工作区进行交互。它提供了一系列工具,用于管理 Slack 频道、发送消息、回复线程、添加表情反应、获取频道历史记录、获取线程回复、获取用户列表和用户详细信息等。
View on GitHub

Overview

基本能力

产品定位

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

核心功能

  1. 频道管理:列出公共频道、获取频道历史记录。
  2. 消息管理:发送消息、回复线程、添加表情反应。
  3. 用户管理:获取用户列表和用户详细信息。

适用场景

  1. 在 Slack 工作区中自动化消息发送和回复。
  2. 获取和分析 Slack 频道的历史消息。
  3. 管理 Slack 用户信息和互动。

工具列表

  1. slack_list_channels:列出工作区中的公共频道。
  2. slack_post_message:向 Slack 频道发送新消息。
  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:确保令牌和工作区 ID 正确复制到配置中。
  4. 频道访问:确保应用已添加到需要访问的频道。
  5. 令牌类型:确保使用用户 OAuth 令牌(以 xoxp- 开头),而不是机器人令牌。

使用教程

使用依赖

  1. 创建一个 Slack 应用:
  2. 访问 Slack Apps 页面
  3. 点击 "Create New App"。
  4. 选择 "From scratch"。
  5. 命名应用并选择工作区。

  6. 配置用户令牌范围:

  7. 导航到 "OAuth & Permissions" 并添加以下范围:

    • channels:history:查看公共频道中的消息和其他内容。
    • channels:read:查看基本频道信息。
    • chat:write:以自己身份发送消息。
    • reactions:write:向消息添加表情反应。
    • users:read:查看用户及其基本信息。
  8. 安装应用到工作区:

  9. 点击 "Install to Workspace" 并授权应用。
  10. 保存以 xoxp- 开头的 "User OAuth Token"。

  11. 获取团队 ID(以 T 开头):

  12. 按照 此指南 获取。

安装教程

本地安装

git clone https://github.com/lars-hagen/slack-user-mcp.git
cd slack-user-mcp
npm install
npm run build

NPX

npx -y @modelcontextprotocol/server-slack-user

Docker

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

通过 Smithery 安装

npx -y @smithery/cli install @lars-hagen/slack-user-mcp2 --client claude

调试方式

  1. 确保所有必需的权限范围已添加到 Slack 应用。
  2. 确保应用已正确安装到工作区。
  3. 确保令牌和工作区 ID 正确复制到配置中。
  4. 确保应用已添加到需要访问的频道。
  5. 确保使用用户 OAuth 令牌(以 xoxp- 开头),而不是机器人令牌。

许可证

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