Slack MCP Server

Slack MCP サーバー

AIアシスタントがSlackワークスペースと連携できるようにするモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、Slack APIを介してメッセージの閲覧、投稿、チャンネルの管理などを行うためのツールを提供します。

特徴

• チャンネル管理: チャンネルの一覧表示、チャンネル情報の取得、チャンネルの作成
• メッセージ操作: メッセージの送信、メッセージ履歴の閲覧、スレッドへの返信
• ユーザー管理: ユーザー情報を取得し、ワークスペースのメンバーを一覧表示する
• ファイル操作: ファイルのアップロード、チャンネルでのファイルの共有
• 検索: ワークスペース全体でメッセージとファイルを検索します
• 反応: メッセージに絵文字反応を追加したり削除したりできます

前提条件

• Python 3.8以上
• 管理者権限を持つSlackワークスペース
• 適切なスコープを持つSlackボットトークン

インストール

1. このリポジトリをクローンします:

2. 依存関係をインストールします:

3. Slack Bot Tokenを設定します（以下の設定セクションを参照）

構成

Slackボットトークンの設定

1. Slack APIにアクセスして新しいアプリを作成します
2. サイドバーの「OAuthと権限」に移動します
3. 次のボット トークン スコープを追加します。
   • channels:read - パブリックチャンネルの基本情報を表示する
   • channels:write - パブリックチャンネルを管理する
   • chat:write - ボットとしてメッセージを送信する
   • chat:write.public - ボットがメンバーではないチャンネルにメッセージを送信します
   • files:read - チャンネルや会話で共有されたファイルを表示する
   • files:write - ファイルのアップロード、編集、削除
   • groups:read - プライベートチャンネルの基本情報を表示する
   • im:read - ダイレクトメッセージに関する基本情報を表示する
   • mpim:read - グループダイレクトメッセージの基本情報を表示する
   • reactions:read - 絵文字の反応とそれに関連するコンテンツを表示します
   • reactions:write - 絵文字反応を追加および編集する
   • search:read - メッセージとファイルを検索する
   • users:read - ワークスペース内のユーザーを表示する
   • channels:history - パブリックチャンネルのメッセージやその他のコンテンツを表示する
   • groups:history - プライベートチャンネルのメッセージやその他のコンテンツを表示する
   • im:history - ダイレクトメッセージ内のメッセージやその他のコンテンツを表示する
   • mpim:history - グループダイレクトメッセージ内のメッセージやその他のコンテンツを表示する
4. ワークスペースにアプリをインストールする
5. 「ボットユーザーOAuthトークン」（ xoxb-で始まる）をコピーします。

環境変数

Slack Bot トークンを環境変数として設定します。

または、プロジェクト ルートに.envファイルを作成します。

使用法

サーバーの実行

サーバーが起動し、stdio 経由で MCP 接続をリッスンします。

Claude Desktopでの使用

Claude Desktop 構成ファイルに次の構成を追加します。

利用可能なツール

サーバーは次のツールを提供します。

チャネルオペレーション

• list_channels() - ワークスペース内のすべてのチャンネルを一覧表示する
• get_channel_info(channel_id) - チャンネルの詳細情報を取得する
• create_channel(name, is_private=False) - 新しいチャンネルを作成する

メッセージ操作

• send_message(channel, text, thread_ts=None) - チャネルにメッセージを送信する
• get_channel_history(channel, limit=10) - チャンネルから最近のメッセージを取得する
• search_messages(query, count=20) - ワークスペース全体のメッセージを検索します

ユーザー操作

• get_user_info(user_id) - ユーザーに関する情報を取得する
• list_users() - ワークスペース内のすべてのユーザーを一覧表示する

ファイル操作

• upload_file(channels, content, filename, title=None) - チャンネルにファイルをアップロードする
• search_files(query, count=20) - ワークスペース内のファイルを検索する

反応作戦

• add_reaction(channel, timestamp, name) - メッセージに絵文字反応を追加する
• remove_reaction(channel, timestamp, name) - メッセージから絵文字反応を削除します

例

メッセージを送信する

チャンネル履歴の取得

メッセージの検索

チャンネルを作成する

エラー処理

サーバーには、次の包括的なエラー処理が含まれています。

• 無効なSlackトークン
• レート制限
• ネットワーク接続の問題
• 無効なチャンネル/ユーザーID
• 権限エラー

セキュリティに関する考慮事項

• Slackボットトークンを安全に保管し、バージョン管理にコミットしないでください
• 環境変数または安全な秘密管理を使用する
• ボットトークンを定期的にローテーションする
• Slackワークスペースでボットのアクティビティを監視する
• 必要最低限の権限のみ付与する

貢献

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. 該当する場合はテストを追加する
5. プルリクエストを送信する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

サポート

問題や質問については:

1. Slack APIドキュメントを確認する
2. MCP仕様を確認する
3. このリポジトリで問題を開く