slack-mcp-server

🚀 松弛 MCP（模型上下文协议）服务器

这是一个实现 Slack MCP 协议的松弛服务器，通过标准化接口提供多种松弛 API 功能。它允许 AI 模型通过统一界面与松弛交互，为模型与松弛的交互提供了便捷的途径。

🚀 快速开始

先决条件

• Node.js（v16 或更高版本）
• npm 或 yarn
• 一个具有管理员访问权限的松弛工作区
• 一个松弛机器人令牌
• 您的松弛团队 ID

安装步骤

1. 克隆此仓库。
2. 安装依赖项：

npm install
# 或者
yarn install

3. 构建 TypeScript 代码：

npm run build
# 或者
yarn build

配置

1. 打开 index.ts 并替换占位符值：

public static readonly BOT_TOKEN = "输入您的机器人令牌";
public static readonly TEAM_ID = "输入您的团队 ID";

用您实际的松弛机器人令牌和团队 ID 替换这些值。

运行服务器

构建项目后，可以运行服务器：

node dist/index.js

在 Cursor 中设置

要在 Cursor 中使用此 MCP 服务器：

1. 打开 Cursor 设置。
2. 转到“模型上下文协议”部分。
3. 添加一个新的工具，配置如下：
   • 名称：slack
   • 命令：node /实际路径/to/your/dist/index.js
   • 工作目录：/实际路径/to/your/project 用您的实际路径替换 /actual path/to/your。

✨ 主要特性

• 列出公共频道
• 发布消息
• 回复线程
• 添加表情反应
• 获取频道历史记录
• 获取线程回复
• 列出用户
• 获取用户资料

📦 安装指南

克隆仓库

克隆此仓库到本地。

安装依赖

npm install
# 或者
yarn install

构建代码

npm run build
# 或者
yarn build

💻 使用示例

可用工具

1. slack_list_channels
   • 功能：列出工作区中的公共频道
   • 可选参数：limit、cursor
2. slack_post_message
   • 功能：向频道发布消息
   • 必要参数：channel_id、text
3. slack_reply_to_thread
   • 功能：回复一条信息线程
   • 必要参数：channel_id、thread_ts、text
4. slack_add_reaction
   • 功能：在一条信息上添加表情符号反应
   • 必要参数：channel_id、timestamp、reaction
5. slack_get_channel_history
   • 功能：获取频道中的近期消息
   • 必要参数：channel_id
   • 可选参数：limit
6. slack_get_thread_replies
   • 功能：获取线程中的所有回复
   • 必要参数：channel_id、thread_ts
7. slack_get_users
   • 功能：列出工作区中的所有用户
   • 可选参数：limit、cursor
8. slack_get_user_profile
   • 功能：获取用户的详细资料信息
   • 必要参数：user_id

🔧 技术细节

开发

要修改服务器：

1. 更改 index.ts 文件。
2. 重建项目：

npm run build
# 或者
yarn build

安全注意事项

• 绝对不要将实际的松弛机器人令牌或团队 ID 提交到版本控制。
• 考虑在生产部署中使用环境变量。
• 确保您的松弛机器人具有执行所需操作的必要 OAuth 作用域。

📄 许可证

本项目采用 MIT 许可证。

🤝 贡献

欢迎提交问题和拉取请求，提出改进建议。