Slack MCP Server

Slack-MCP サーバー

Slack APIにアクセスするためのMCP（Model Context Protocol）サーバー。このサーバーにより、AIアシスタントは標準化されたインターフェースを介してSlack APIと対話できるようになります。

特徴

利用可能なツール:

• slack_list_channels - ワークスペース内のパブリックチャンネルをページ区切りで一覧表示します
• slack_post_message - Slackチャンネルに新しいメッセージを投稿する
• slack_reply_to_thread - Slack の特定のメッセージスレッドに返信する
• slack_add_reaction - メッセージに反応絵文字を追加する
• slack_get_channel_history - チャンネルから最近のメッセージを取得する
• slack_get_thread_replies - メッセージスレッド内のすべての返信を取得する
• slack_get_users - ワークスペース内のすべてのユーザーの基本プロフィール情報を取得します
• slack_get_user_profile - ユーザーのプロフィール情報を取得する
• slack_search_messages - ワークスペース内のメッセージを検索する

クイックスタート

インストール

注意: 現在、GitHub レジストリでホストされているため、PAT が必要です。

構成

次の環境変数を設定する必要があります。

• SLACK_BOT_TOKEN : Slack ボットユーザー OAuth トークン
• SLACK_USER_TOKEN : Slack ユーザー OAuth トークン (メッセージ検索などの一部の機能に必要)

.envファイルを作成して、次の環境変数を設定することもできます。

使用法

MCPサーバーを起動する

直接：

または、インストールしたモジュールを node で実行します。

クライアントの MCP 構成 json を編集します。

実装パターン

このサーバーは次の実装パターンを採用しています。

1. Zodスキーマを使用してリクエスト/レスポンスを定義する
   • リクエストスキーマ: 入力パラメータを定義する
   • レスポンススキーマ: 必要なフィールドに限定したレスポンスを定義する
2. 実装フロー：
   • Zodスキーマでリクエストを検証する
   • Slack WebAPIを呼び出す
   • Zodスキーマを使用してレスポンスを解析し、必要なフィールドに限定する
   • JSONとして返す

たとえば、 slack_list_channels実装は、 ListChannelsRequestSchemaを使用してリクエストを解析し、 slackClient.conversations.listを呼び出し、 ListChannelsResponseSchemaを使用して解析されたレスポンスを返します。

発達

利用可能なスクリプト

• npm run dev - ホットリロードで開発モードでサーバーを起動します
• npm run build - 本番環境用にプロジェクトをビルドする
• npm run start - 本番サーバーを起動する
• npm run lint - リンティングチェックを実行する（ESLint と Prettier）
• npm run fix - リンティングの問題を自動的に修正する

貢献

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. テストとリンティングを実行する: npm run lint
4. 変更をコミットする
5. ブランチにプッシュする
6. プルリクエストを作成する