Slack MCP Server Zp1

🚀 Slack MCP 服務器

Slack MCP 服務器專為 Slack API 打造，它能夠賦能 Claude，使其與 Slack 工作區實現交互，為工作溝通帶來更多便利。

✨ 主要特性

本服務器提供了一系列實用工具，用於與 Slack 工作區進行交互，具體如下：

1. slack_list_channels：列出工作區中的公共頻道。

   • 可選輸入：
     • limit（數字，默認：100，最大值：200）：返回的最大頻道數量。
     • cursor（字符串）：分頁遊標的下一頁標識符。
   • 返回結果：包含 ID 和其他信息的頻道列表。

2. slack_post_message：向 Slack 頻道發送新消息。

   • 必填輸入：
     • channel_id（字符串）：要發送消息的目標頻道 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（字符串）：目標頻道 ID。
   • 可選輸入：
     • limit（數字，默認：10）：要獲取的消息數量。
   • 返回結果：包含內容和其他元數據的消息列表。

6. slack_get_thread_replies：獲取某條消息線程下的所有回覆。

   • 必填輸入：
     • channel_id（字符串）：包含線程的頻道。
     • thread_ts（字符串）：父消息的時間戳。
   • 返回結果：包含 ID 和其他信息的回覆列表。

7. slack_list_users：獲取工作區中的用戶列表。

   • 可選輸入：
     • cursor（字符串）：分頁遊標的下一頁標識符。
   • 返回結果：包含用戶 ID、名稱和角色等信息的用戶列表。

📦 安裝指南

創建 Slack 應用

1. 訪問 Slack 開發者門戶，點擊“Create New App”創建新應用。
2. 填寫應用的基本信息，如名稱和描述，然後保存。

配置權限

1. 進入剛創建的應用設置界面。
2. 導航至“Permissions”（權限）部分。
3. 啟用所需的機器人權限，例如：
   • bot：允許機器人用戶加入頻道。
   • channels:read：讀取頻道信息。
   • messages:read：讀取消息歷史。
   • messages:write：發送消息。

安裝應用

1. 返回到應用設置界面，找到“Install App”（安裝應用）選項。
2. 按照提示授權你的 Slack 工作區，並完成機器人用戶的添加。

獲取團隊 ID 和 Bot Token

1. 安裝完成後，在“Basic Information”（基本信息）部分找到並記錄下你的 Team ID（團隊 ID）。
2. 進入“Tokens & Signing Secret”（令牌與簽名密鑰）部分，生成一個新的 Bot User OAuth Token（機器人用戶 OAuth 令牌），然後複製該令牌。

💻 使用示例

在 Claude Desktop 中的配置

以下是使用 JSON 格式的配置示例：

{
  "mcp.servers": {
    "slack.example.com:8090": {
      "type": "http",
      "url": "http://localhost:8090",
      "headers": {
        "Authorization": "Bearer YOUR_BOT_TOKEN"
      }
    }
  }
}

Docker 構建命令

docker build -t mcp/slack -f src/slack/Dockerfile .

📚 詳細文檔

故障排除

如遇權限問題，請檢查：

1. 所需的所有權限是否已正確添加到 Slack 應用中。
2. 應用是否已成功安裝到目標工作區。
3. 令牌和團隊 ID 是否準確無誤地配置在相關設置中。
4. 應用是否已被添加至其需要訪問的頻道。

📄 許可證

此 MCP 服務器遵循 MIT 許可證。這意味著您可以自由使用、修改和分發軟件，前提是遵守 MIT 許可證的條款和條件。更多詳情，請參閱項目倉庫中的 LICENSE 文件。