Slack MCP Server Zp1

🚀 Slack MCP サーバー

Slack API用のMCPサーバーで、Claudeと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トークンの取得

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ファイルを参照してください。