MCP Slack

🚀 MCP 服務器用於 Slack

一個用於將 AI 助手集成到 Slack 工作區的 Model Context Protocol (MCP) 服務器實現，藉助該服務器，AI 助手可與 Slack 工作區進行交互，實現多種功能。

🚀 快速開始

此包提供了一個 MCP 服務器，使 AI 助手能夠與 Slack 工作區交互。它允許 AI 模型：

• 列出和瀏覽頻道
• 向頻道發送消息
• 回覆線程
• 在消息上添加反應
• 獲取頻道歷史記錄
• 獲取線程回覆
• 列出用戶並檢索用戶資料

✨ 主要特性

• 支持 AI 助手與 Slack 工作區的多種交互操作，如消息發送、線程回覆等。
• 提供了一系列 Slack 集成工具，方便使用。

📦 安裝指南

# 從 npm 安裝
npm install shouting-mcp-slack

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

你可以在 npm 上找到該包：shouting-mcp-slack

先決條件

你需要設置一個 Slack 機器人並獲得必要的憑證：

1. 在 Slack API 控制檯 中創建一個 Slack 應用。
2. 添加以下 Bot Token 權限範圍：
   • channels:history
   • channels:read
   • chat:write
   • reactions:write
   • users:read
   • users:read.email
3. 將應用安裝到你的工作區。
4. 複製 Bot User OAuth Token。

配置

服務器需要以下環境變量：

• SLACK_BOT_TOKEN：你的 Slack Bot User OAuth Token。
• 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