Slack Bot MCP

MCPAI代理

提供方 Hais · 包名 @modelcontextprotocol/inspector

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

一个基于TypeScript的Slack工作区集成服务器,通过MCP协议实现AI助手与Slack频道、用户、消息和文件的交互。

一句话选型结论

按资料字段整理

Slack Bot MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude、Cursor,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式支持远程部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 17 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量17暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Slack集成TypeScript本地部署AI助手工作区管理消息处理文件操作

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/inspector node build/index.js

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 17 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 17 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Slack Bot MCP当前 17 stdio · 本地进程 支持远程部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Hais上游标注的维护方 Hais
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@modelcontextprotocol/inspector · Node.js本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

13.6 KB
来自项目仓库与上游目录的原文,未做删改

Slack MCP 服务器

一个基于TypeScript的模型上下文协议(MCP)服务器,提供全面的Slack工作区集成。该服务器使AI助手能够通过MCP协议与Slack频道、用户、消息、文件等进行交互。

目录

  • 特点/特性
  • 先决条件
  • 安装与设置
  • 步骤1:项目设置
  • 步骤2:创建Slack应用
  • 第三步:配置环境
  • 步骤4:构建与验证
  • 测试您的设置
  • 使用
  • 工具示例
  • 故障排除

特点/功能

渠道管理

  • 列出频道 - 列出工作区频道并提供过滤选项
  • 获取频道信息 - 获取特定频道的详细信息
  • 创建频道 - 创建新的公共或私有频道
  • 归档频道 - 归档频道

用户管理

  • 列出用户 - 列出工作区中的所有用户
  • 获取用户信息 - 获取详细的用户资料信息
  • 邀请加入频道 - 邀请用户加入频道

信息传递/消息服务

  • 发送消息 - 向频道发送文本消息
  • 更新消息 - 更新现有消息
  • 删除消息 - 删除消息
  • 获取频道历史记录 - 分页获取消息历史
  • 搜索消息 - 在整个工作区中搜索消息
  • 发送格式化消息 - 使用 Block Kit 格式发送消息

文件操作

  • 上传文件 - 将文件上传到频道

反应

  • 添加反应 为消息添加表情符号反应
  • 移除反应 - 移除表情符号反应

工作区信息

  • 获取团队信息 - 获取工作区/团队信息

先决条件

在开始之前,请确保您已具备:

  • Node.js 18 或更高版本 - 与以下内容核对: node --version
  • npm - 与以下内容核对: npm --version
  • Slack工作区管理员访问权限 - 您需要获得创建和安装应用程序的权限
  • 预计设置时间: 约20分钟

安装与设置

步骤1:项目设置(5分钟)

克隆仓库并安装依赖项:```bash

Clone the repository

git clone
cd slack-bot-mcp

Install dependencies

npm install


**✓ 验证:** 跑 `npm list @modelcontextprotocol/sdk` 确认已安装MCP SDK。

______________________________________________________________________

### 步骤2:创建Slack应用(10分钟)

#### 2.1 创建应用程序

1. 访问 https://api.slack.com/apps
1. 点击 **“创建新应用”** → **“从零开始”**
1. 输入应用名称(例如,“MCP Bot”)并选择您的工作区
1. 点击 **“创建应用”**

#### 2.2 配置OAuth范围

范围 · 目的 · 使用者
`channels:read` · 查看基本频道信息 · list_channels, get_channel_info
`channels:write` · 创建频道 · create_channel
`channels:manage` · 存档频道,邀请用户 · archive_channel, invite_to_channel
`users:read` · 查看用户资料 · 列出用户列表,获取用户信息
`chat:write` · 发送和更新消息 · send_message, update_message, delete_message
`files:write` · 将文件上传到Slack · upload_file
`reactions:write` 添加/删除表情符号反应 · add_reaction, remove_reaction
`team:read` · 获取工作区信息 · get_team_info
`search:read` · 搜索消息 · search_messages

> **💡 提示:** 每个作用域对于特定工具的功能运行都是必需的。缺少作用域将导致“missing_scope”错误。

#### 2.3 安装到工作区

1. 滚动到 **“为您的工作区提供的OAuth令牌”**
1. 点击 **“安装到工作区”**
1. 检查权限并点击 **“允许”**

#### 2.4 复制您的机器人令牌

1. 安装后,您会看到 **“机器人用户OAuth令牌”**
1. 点击 **“复制”** (令牌以...开始 `xoxb-`)
1. 请妥善保管这个令牌——下一步会需要用到它

**✓ 验证:** 您的令牌应该看起来像这样: `xoxb---`

______________________________________________________________________

### 步骤3:配置环境(2分钟)

创建您的环境配置:```bash
# Copy the example file
cp .env.example .env

编辑 .env 并添加您的机器人令牌:```bash
SLACK_BOT_TOKEN=xoxb-your-actual-token-here


**✓ 验证:** 运行此命令以确认您的令牌已加载:```bash
node -e "require('dotenv').config(); console.log('Token loaded:', !!process.env.SLACK_BOT_TOKEN)"

你应该看到: Token loaded: true

> ⚠️ 常见问题: 确保你的令牌以……开头 xoxb- (不是 xoxp- 或者 xoxa-)


步骤4:构建并验证(3分钟)

构建TypeScript项目:```bash
npm run build


**✓ 验证:** 确认 `build/` 目录已创建:```bash
ls build/index.js

你应该能看到编译后的结果 index.js 文件。


测试您的设置

在与Claude Desktop集成之前,请测试确保一切正常运行:

使用MCP Inspector

MCP Inspector 提供了一个图形用户界面 (GUI) 来测试您的工具:```bash
npx @modelcontextprotocol/inspector node build/index.js


这将打开一个网页界面,您可以在其中:

- 查看所有可用工具
- 使用样本输入测试单个工具
- 查看响应并调试错误

### 快速测试命令

在MCP检查器中尝试这些简单测试:

1. **列出频道:**

- 工具: `list_channels`
- 参数: `{"limit": 5}`
- 预期结果:您工作区频道的列表

1. **获取团队信息:**

- 工具: `get_team_info`
- 参数: `{}`
- 预期:您的工作区名称及详细信息

1. **列出用户:**

- 工具: `list_users`
- 参数: `{"limit": 5}`
- 预期结果:工作区用户列表

> **✓ 成功指标:** 如果这些命令返回数据(而非错误),则说明您的设置是正确的!

> **⚠️ 故障排除:** 如果你看到“invalid_auth”或“token_revoked”,请仔细检查你的 `SLACK_BOT_TOKEN` 在……里(或“在……中”) `.env` 文件。

______________________________________________________________________

## 使用方法

### 使用Claude Desktop

在您的Claude Desktop配置文件中添加:

**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%/Claude/claude_desktop_config.json`

#### 选项1:直接从GitHub获取(推荐)

使用 `npx` 直接从GitHub仓库运行:```json
{
"mcpServers": {
"slack": {
"command": "npx",
"args": [
"github:Hais/slack-bot-mcp"
],
"env": {
"SLACK_BOT_TOKEN": "xoxb-your-token-here"
}
}
}
}

好处:

  • ✓ 无需本地安装
  • ✓ 始终使用最新版本
  • ✓ 更简单的配置
  • ✓ 在任何安装了Node.js的机器上都能运行

选项2:本地安装

用于本地开发或离线使用:```json
{
"mcpServers": {
"slack": {
"command": "node",
"args": ["/absolute/path/to/slack-bot-mcp/build/index.js"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-your-token-here"
}
}
}
}


**本地安装设置:**

1. 克隆并构建项目(参见 安装与设置)
1. 替换 `/absolute/path/to/slack-bot-mcp` 包含您的完整项目路径
- 通过运行来找到它 `pwd` 在你的项目目录中
- 示例: `/Users/yourname/projects/slack-bot-mcp/build/index.js`

______________________________________________________________________

**重要提示:**

1. **令牌配置:** 设定;套装 `SLACK_BOT_TOKEN` 在上面所示的配置文件中

- 配置文件中的token优先级高于 `.env` 文件
- 确保您的令牌安全,切勿将其提交到版本控制系统中

1. **需要重启:** 编辑配置文件后,重启Claude桌面版

1. **首次运行:** 第一次使用 `npx`它将下载并缓存该包(可能需要几秒钟)

**✓ 验证:** 打开Claude桌面版并输入:“列出我的Slack频道”。如果配置正确,Claude将使用 `list_channels` 工具。

### 与其他MCP客户端一起

服务器运行在stdio传输层,并且可以与任何MCP客户端集成:```bash
node build/index.js

开发模式

对于支持热重载的开发:```bash
npm run dev


## 工具示例

### 列出频道```json
{
"name": "list_channels",
"arguments": {
"types": "public_channel,private_channel",
"exclude_archived": true,
"limit": 50
}
}

发送消息```json

{
"name": "send_message",
"arguments": {
"channel": "C1234567890",
"text": "Hello from MCP!"
}
}


### 使用 Block Kit 发送格式化消息```json
{
"name": "send_formatted_message",
"arguments": {
"channel": "C1234567890",
"text": "Fallback text",
"blocks": [
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": "*Hello* from MCP with _formatting_!"
}
}
]
}
}

搜索消息```json

{
"name": "search_messages",
"arguments": {
"query": "important announcement",
"count": 10,
"sort": "timestamp"
}
}


### 上传文件```json
{
"name": "upload_file",
"arguments": {
"channels": ["C1234567890"],
"content": "File content here",
"filename": "report.txt",
"title": "Monthly Report"
}
}

添加反应```json

{
"name": "add_reaction",
"arguments": {
"channel": "C1234567890",
"timestamp": "1234567890.123456",
"name": "thumbsup"
}
}


## 所需的OAuth范围

确保您的Slack应用拥有这些权限范围:

| 范围 | 目的 |
|-------|---------|
| `channels:read` | 列出并获取频道信息 |
| `channels:write` | 创建频道 |
| `channels:manage` | 存档频道 |
| `users:read` | 列出并获取用户信息 |

| `chat:write` 发送、更新和删除消息
`files:write` · 上传文件
`reactions:write` · 添加和移除反应
`team:read` · 获取工作区信息
`search:read` · 搜索消息

## 项目结构```
slack-bot-mcp/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── tools/
│   │   ├── channels.ts       # Channel management tools
│   │   ├── users.ts          # User management tools
│   │   ├── messages.ts       # Messaging tools
│   │   ├── files.ts          # File upload tool
│   │   ├── reactions.ts      # Reaction tools
│   │   └── workspace.ts      # Workspace info tool
│   ├── config/
│   │   └── credentials.ts    # Environment config loader
│   ├── types/
│   │   └── slack.ts          # TypeScript interfaces
│   └── utils/
│       ├── slack-client.ts   # Slack API wrapper
│       └── validators.ts     # Zod input validators
├── build/                    # Compiled JavaScript
├── .env                      # Your environment variables
├── .env.example             # Environment template
├── package.json
├── tsconfig.json
└── README.md

故障排除

设置问题

“需要设置 SLACK_BOT_TOKEN 环境变量”

原因: 服务器找不到您的机器人令牌。

解决方案:

  1. 验证 .env 文件存在于项目根目录中: ls -la .env
  2. 检查令牌格式: cat .env (应显示 SLACK_BOT_TOKEN=xoxb-...)
  3. 如果使用Claude桌面配置,请确保令牌已放置在 env 部分;章节
  4. 更改后请重启您的MCP客户端

“缺少必需的OAuth作用域”

原因: 您的机器人令牌没有必要的权限。

解决方案:

  1. 访问 https://api.slack.com/apps → 选择您的应用 → “OAuth & 权限”
  2. 添加缺失的作用域(错误信息会指明是哪一个)
  3. 点击“重新安装到工作区”(在添加作用域后必须执行此操作)
  4. 复制新的机器人令牌并更新您的配置

> 💡 注: 更改范围后,您必须重新安装应用程序。旧的令牌不会自动获得新权限。

运行时问题

“频道未找到”或“用户未找到”

原因: 你正在使用频道/用户名而不是ID。

解决方案:

  • 频道ID以...开头 C (公开), G (私人),或 D (直接邮件)
  • 用户ID以……开头 U
  • 使用 list_channels 或者 list_users 用于查找正确ID的工具

示例:```json
// ❌ Wrong
{"channel": "general"}

// ✓ Correct
{"channel": "C1234567890"}


#### “无效的授权”或“令牌被撤销”

**原因:** 机器人令牌不正确或已过期。

**解决方案:**

1. 访问 https://api.slack.com/apps → 选择您的应用 → “OAuth & 权限”
1. 复制当前的“机器人用户OAuth令牌”
1. 更新你的 `.env` 文件或Claude Desktop配置
1. 重启MCP服务器

#### 速率限制

**原因:** Slack API有速率限制(第三层级:每分钟50+次请求)。

**解决方案:**

- 在快速请求之间添加延迟
- 对于大数据集,使用分页参数(limit,cursor)
- 在错误消息中监控速率限制头部信息

#### MCP 检查器无法启动

**原因:** 端口已被使用或 Node.js 存在问题。

**解决方案:**```bash
# Kill any existing inspector processes
pkill -f "mcp.*inspector"

# Try again
npx @modelcontextprotocol/inspector node build/index.js

寻求帮助

如果你还是卡住了:

  1. 检查构建输出: 跑 npm run build 并查找 TypeScript 错误
  2. 验证节点版本: 跑 node --version (需18岁以上)
  3. 手动测试代币: 请使用Slack的API测试工具,网址为:https://api.slack.com/methods/auth.test/test
  4. 启用调试日志记录: 设定 DEBUG=* 环境变量

仍然有问题吗?请在(相关平台/系统)提交一个问题 GitHub 仓库 与;带有;和

  • 错误信息(全文)
  • 您的 Node.js 版本
  • 复现步骤

发展

建筑```bash

npm run build


### 在开发中运行```bash
npm run dev

使用MCP Inspector进行测试```bash

npx @modelcontextprotocol/inspector node build/index.js
```

许可证

ISC(Internet Service Provider,互联网服务提供商)

做出贡献

欢迎贡献!请随时提交拉取请求。

致谢

从Python实现移植而来:https://github.com/piekstra/slack-mcp-server

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Slack Bot MCP 怎么安装?

在客户端按下面的安装命令接入:npx @modelcontextprotocol/inspector node build/index.js。对应的包名是 @modelcontextprotocol/inspector。装完在客户端配置里引用同一个包或端点。

Slack Bot MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Slack Bot MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Slack Bot MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Slack Bot MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Slack Bot MCP 能提供哪些能力?

资料显示约 17 个工具;能力标签包括 Slack、工作区管理、TypeScript、Claude、文件操作。具体工具清单以官方文档为准。

Slack Bot MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Slack Bot MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。