Slack MCP Server

🚀 slack - mcp - server

一個用於訪問 Slack API 的 MCP（模型上下文協議） 服務器。此服務器允許 AI 助手通過標準化接口與 Slack API 進行交互，為 AI 與 Slack 的集成提供了便利。

🚀 快速開始

📦 安裝指南

npm install @ubie-oss/slack-mcp-server

⚠️ 重要提示

該包現在託管在 GitHub Registry 上，因此需要使用你的 GitHub 個人訪問令牌（PAT）。

配置

你需要設置以下環境變量：

• SLACK_BOT_TOKEN：Slack 機器人用戶OAuth令牌
• SLACK_USER_TOKEN：Slack 用戶OAuth令牌（某些功能如消息搜索所需）

你也可以創建一個 .env 文件來設置這些環境變量：

SLACK_BOT_TOKEN=xoxb-your-bot-token
SLACK_USER_TOKEN=xoxp-your-user-token

使用

啟動 MCP 服務器

直接運行：

npx @ubie-oss/slack-mcp-server

或者，通過 Node 執行已安裝的模塊：

node node_modules/.bin/slack-mcp-server

編輯客戶端配置 JSON：

{
  "slack": {
    "command": "npx",
    "args": [
      "-y",
      "@ubie-oss/slack-mcp-server"
    ],
    "env": {
      "NPM_CONFIG_//npm.pkg.github.com/:_authToken": "<your-github-pat>",
      "SLACK_BOT_TOKEN": "<your-bot-token>",
      "SLACK_USER_TOKEN": "<your-user-token>"
    }
  }
}

✨ 主要特性

可用工具：

• slack_list_channels - 列出工作區中的公共頻道，支持分頁
• slack_post_message - 向 Slack 頻道發送新消息
• slack_reply_to_thread - 回覆特定的消息線程
• slack_add_reaction - 在消息上添加表情符號
• slack_get_channel_history - 獲取頻道中的最近消息
• slack_get_thread_replies - 獲取消息線程中的所有回覆
• slack_get_users - 檢索工作區中所有用戶的簡要配置文件信息
• slack_get_user_profile - 獲取特定用戶的個人資料信息
• slack_search_messages - 在工作區中搜索消息

🔧 技術細節

此服務器採用以下實現模式：

1. 使用 Zod 模式定義請求/響應
   • 請求模式：定義輸入參數
   • 響應模式：限制必要的字段返回
2. 實現流程：
   • 使用 Zod 模式驗證請求
   • 調用 Slack WebAPI
   • 使用 Zod 模式解析響應，僅保留必要字段
   • 返回 JSON 格式的響應

例如，slack_list_channels 的實現使用 ListChannelsRequestSchema 驗證請求，調用 slackClient.conversations.list，並返回通過 ListChannelsResponseSchema 解析的響應，僅包含必要的字段。

📚 詳細文檔

開發

可用腳本

• npm run dev - 以開發模式啟動服務器，並啟用熱重載
• npm run build - 構建項目用於生產環境
• npm run start - 啟動生產服務器
• npm run lint - 運行代碼檢查（ESLint 和 Prettier）
• npm run fix - 自動修復代碼檢查問題

貢獻指南

1. 叉克倉庫
2. 創建功能分支
3. 運行測試和代碼檢查：npm run lint
4. 提交更改
5. 推送到分支
6. 創建 Pull Request