Slack Explorer MCP

🚀 Slack Explorer MCP Server

Slackのメッセージやスレッドから情報を取得することに特化した、モデルコンテキストプロトコル（MCP）サーバーです。ユーザートークン（xoxp）を使用して、認証済みユーザーが閲覧できるメッセージにアクセスするためのツールを提供します。

✨ 主な機能

利用可能なツール

メッセージ検索 (search_messages)

• Slackのメッセージを高度なフィルタリングオプションで検索できます。チャンネル、ユーザー、日付範囲、特定の機能（リアクション、ファイルなど）で検索できます。
• パラメータ
  • query: 基本的な検索クエリ（修飾子なし）
  • in_channel: チャンネル名でフィルタリング（例: "general", "team-dev"）
  • from_user: 特定のユーザー（ユーザーID）からのメッセージを検索
  • with: 特定のユーザー（ユーザーIDの配列）とのDM/スレッドを検索
  • before, after, on: 日付範囲のフィルタリング（YYYY-MM-DD形式）
  • during: 期間指定（例: "July", "2023"）
  • has: 特定の機能を含むメッセージ（絵文字、"pin"、"file"、"link"、"reaction"）
  • hasmy: 特定の絵文字でリアクションしたメッセージ
  • sort: 並び替え方法（"score" または "timestamp"）
  • count: 1ページあたりの結果数（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"]）。利用可能なタイプ: lists, canvases, documents, emails, images, pdfs, presentations, snippets, spreadsheets, audio, videos
  • in_channel: チャンネル名でフィルタリング（例: "general", "team-dev"）
  • from_user: 特定のユーザー（ユーザーID）からのファイルを検索
  • with_users: 特定のユーザー（ユーザーIDの配列）とのDM/スレッド内のファイルを検索
  • before, after, on: 日付範囲のフィルタリング（YYYY-MM-DD形式）
  • count: 1ページあたりの結果数（1 - 100、デフォルト: 20）
  • page: ページ番号（1 - 100、デフォルト: 1）

キャンバスコンテンツ (get_canvas_content)

• SlackキャンバスのHTMLコンテンツを取得します。キャンバスIDを指定することで、キャンバスコンテンツを取得できます。
• パラメータ
  • canvas_ids: キャンバスIDの配列（必須、最大20）

📦 インストール

Slackユーザートークンの取得

1. Slack API でアプリを作成します。
2. OAuth & Permissionsで以下のユーザートークンスコープを追加します。
   • channels:history - パブリックチャンネル用
   • groups:history - プライベートチャンネル用
   • im:history - ダイレクトメッセージ用
   • mpim:history - グループダイレクトメッセージ用
   • search:read - メッセージ検索用
   • users.profile:read - ユーザープロファイル用
   • users:read - ユーザー情報用
   • files:read - ファイルコンテンツアクセス用
3. アプリをワークスペースにインストールします。
4. ユーザーOAuthトークン（xoxp- で始まる）を取得します。
   • ヒント: 同じワークスペース内の複数のユーザーで使用する場合は、彼らをコラボレーターとして追加し、各ユーザーにOAuth & Permissionsから再インストールさせて、独自のユーザー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検索を実行します。

   例:

   • "先週のgeneralチャンネルで会議関連のメッセージを検索"
   • "@john.doeからの'project'に関するメッセージを検索"
   • "この投稿のすべてのスレッド返信を取得"

💻 使用例

一般的な検索パターン

特定のチャンネルでの検索

generalチャンネルで "release" メッセージを検索

特定のユーザーからのメッセージを検索

昨日の@john.doeからのメッセージを検索

リアクションのあるメッセージを検索

:fire: リアクションのあるメッセージを検索

自分がリアクションしたメッセージを検索

:eyes: でリアクションしたメッセージを検索

ファイル添付のあるメッセージを検索

ファイル添付のあるメッセージを検索

ストリーミング可能なHTTPサーバーとしての使用

デフォルトでは、サーバーはMCP通信にstdioを使用します。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