Slack Explorer MCP

🚀 Slack Explorer MCP Server

這是一個專門用於從Slack消息和線程中檢索信息的模型上下文協議（MCP）服務器。藉助用戶令牌（xoxp），它提供了一系列工具，可幫助用戶訪問已認證用戶可見的消息。

🚀 快速開始

獲取Slack用戶令牌

1. 在 Slack API 創建一個應用。
2. 在“OAuth & 權限”中添加以下用戶令牌權限範圍：
   • channels:history - 用於公共頻道
   • groups:history - 用於私有頻道
   • im:history - 用於直接消息
   • mpim:history - 用於群組直接消息
   • search:read - 用於消息搜索
   • users.profile:read - 用於用戶資料
   • users:read - 用於用戶信息
   • files:read - 用於文件內容訪問
3. 將應用安裝到你的工作區。
4. 獲取用戶OAuth令牌（以xoxp - 開頭）
   • 提示：若要在同一工作區為多個用戶使用，可將他們添加為協作者，讓每個用戶從“OAuth & 權限”重新安裝以獲取自己的用戶OAuth令牌。

MCP服務器配置

1. 配置 mcp.json

   {
     "mcpServers": {
       "slack-explorer-mcp": {
         "command": "docker",
         "args": ["run", "-i", "--rm", "--pull", "always",
           "-e", "SLACK_USER_TOKEN=xoxp-your-token-here",
           "ghcr.io/shibayu36/slack-explorer-mcp:latest"
         ]
       }
     }
   }
   

   如果你使用Claude Code：

   claude mcp add slack-explorer-mcp -- docker run -i --rm --pull always \
     -e SLACK_USER_TOKEN=xoxp-your-token-here \
     ghcr.io/shibayu36/slack-explorer-mcp:latest
   

2. 使用代理執行Slack搜索 示例：

   • "搜索上週在通用頻道中與會議相關的消息"
   • "查找 @john.doe 關於 '項目' 的消息"
   • "獲取此帖子的所有線程回覆"

✨ 主要特性

可用工具

• 消息搜索 (search_messages)

  • 可使用高級過濾選項搜索Slack消息。你可以按頻道、用戶、日期範圍和特定特徵（反應、文件等）進行搜索。
  • 參數
    • query：基本搜索查詢（無修飾符）
    • in_channel：按頻道名稱過濾（例如，"general"、"team - dev"）
    • from_user：搜索特定用戶的消息（用戶ID）
    • with：搜索與特定用戶的直接消息/線程（用戶ID數組）
    • before、after、on：日期範圍過濾（YYYY - MM - DD格式）
    • during：時間段指定（例如，"July"、"2023"）
    • has：包含特定特徵的消息（表情符號、"pin"、"file"、"link"、"reaction"）
    • hasmy：你用特定表情符號做出反應的消息
    • sort：排序方法（"score" 或 "timestamp"）
    • count：每頁結果數量（1 - 100，默認：20）
    • page：頁碼（1 - 100，默認：1）

• 線程回覆 (get_thread_replies)

  • 獲取消息線程中的所有回覆。支持分頁，可有效處理大量回復。
  • 參數
    • channel_id：頻道ID（必需）
    • thread_ts：父消息時間戳（必需）
    • limit：要檢索的回覆數量（1 - 1000，默認：100）
    • cursor：分頁遊標

• 用戶資料 (get_user_profiles)

  • 批量獲取多個用戶的資料信息。通過指定用戶ID列表，可檢索顯示名稱、真實姓名、電子郵件地址和其他資料信息。
  • 參數
    • user_ids：用戶ID數組（必需，最多100個）

• 按顯示名稱搜索用戶 (search_users_by_name)

  • 按用戶的顯示名稱搜索用戶。支持精確匹配和部分匹配搜索，且區分大小寫。
  • 參數
    • display_name：要搜索的顯示名稱（必需）
    • exact：啟用精確匹配搜索

• 文件搜索 (search_files)

  • 搜索諸如畫布、PDF和圖像等文件。你可以按文件類型、頻道、用戶和日期範圍進行過濾。
  • 參數
    • query：基本搜索查詢（無修飾符）
    • types：按文件類型過濾（例如，["canvases", "pdfs"]）。可用類型：列表、畫布、文檔、電子郵件、圖像、PDF、演示文稿、代碼片段、電子表格、音頻、視頻
    • in_channel：按頻道名稱過濾（例如，"general"、"team - dev"）
    • from_user：搜索特定用戶的文件（用戶ID）
    • with_users：搜索與特定用戶的直接消息/線程中的文件（用戶ID數組）
    • before、after、on：日期範圍過濾（YYYY - MM - DD格式）
    • count：每頁結果數量（1 - 100，默認：20）
    • page：頁碼（1 - 100，默認：1）

• 畫布內容 (get_canvas_content)

  • 獲取Slack畫布的HTML內容。通過指定畫布ID來檢索畫布內容。
  • 參數
    • canvas_ids：畫布ID數組（必需，最多20個）

💻 使用示例

常見搜索模式

• 在特定頻道中搜索

  搜索通用頻道中包含 "release" 的消息
  

• 搜索特定用戶的消息

  搜索 @john.doe 昨天的消息
  

• 搜索帶有反應的消息

  搜索帶有 :fire: 反應的消息
  

• 搜索你做出反應的消息

  搜索你用 :eyes: 做出反應的消息
  

• 搜索帶有文件附件的消息

  搜索帶有文件附件的消息
  

作為可流式HTTP服務器使用

默認情況下，服務器使用標準輸入輸出進行MCP通信。你可以通過設置 TRANSPORT=http 環境變量將其作為可流式HTTP服務器啟動。在HTTP模式下，使用 X - Slack - User - Token 頭傳遞Slack令牌。

啟動服務器：

# 啟動HTTP服務器（默認：所有接口 0.0.0.0，端口 8080）
docker run -i --rm --pull always \
  -e TRANSPORT=http \
  -p 8080:8080 \
  ghcr.io/shibayu36/slack-explorer-mcp:latest

# 使用自定義主機和端口啟動
docker run -i --rm --pull always \
  -e TRANSPORT=http \
  -e HTTP_HOST=127.0.0.1 \
  -e HTTP_PORT=9090 \
  -p 9090:9090 \
  ghcr.io/shibayu36/slack-explorer-mcp:latest