MCP Server for Slack

这是一个用于将AI助手与Slack工作区集成的Model Context Protocol (MCP)服务器实现。

概述

此包提供了一个MCP服务器，使AI助手能够与Slack工作区进行交互。它允许AI模型执行以下操作：

• 列出和浏览频道
• 向频道发送消息
• 回复线程
• 对消息添加反应
• 获取频道历史记录
• 获取线程回复
• 列出用户并获取用户资料

安装

# 从npm安装
npm install shouting-mcp-slack

# 或者全局安装
npm install -g shouting-mcp-slack

您可以在npm上找到该包：shouting-mcp-slack

预备条件

您需要设置一个Slack机器人，并获得必要的凭据：

1. 在Slack API控制台中创建一个Slack应用
2. 添加以下Bot令牌范围：
   • channels:history
   • channels:read
   • chat:write
   • reactions:write
   • users:read
   • users:read.email
3. 将应用安装到您的工作区
4. 复制Bot用户OAuth令牌

配置

服务器需要以下环境变量：

• SLACK_BOT_TOKEN：您的Slack Bot用户OAuth令牌
• SLACK_TEAM_ID：您的Slack团队ID

使用方法

作为CLI工具运行

# 设置环境变量
export SLACK_BOT_TOKEN=xoxb-your-token
export SLACK_TEAM_ID=your-team-id

# 运行服务器
mcp-server-slack

在您的代码中使用

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { SlackClient } from "shouting-mcp-slack";

// 初始化服务器和客户端
const server = new Server({...});
const slackClient = new SlackClient(process.env.SLACK_BOT_TOKEN);

// 注册自定义处理程序
// ...

提供的工具

服务器提供了以下Slack集成工具：

• slack_list_channels：列出可用频道
• slack_post_message：向频道发送消息
• slack_reply_to_thread：回复线程
• slack_add_reaction：对消息添加反应
• slack_get_channel_history：从频道获取消息历史记录
• slack_get_thread_replies：获取线程中的回复
• slack_get_users：列出工作区中的用户
• slack_get_user_profile：获取用户的资料

许可证

ISC

作者

shouting.hsiao@gmail.com

仓库

https://github.com/z9905080/mcp-slack