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 - ワークスペース内のメッセージを検索する

クイックスタート

インストール

npm install @ubie-oss/slack-mcp-server

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

構成

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

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

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

SLACK_BOT_TOKEN=xoxb-your-bot-token
SLACK_USER_TOKEN=xoxp-your-user-token

使用法

MCPサーバーを起動する

直接：

npx @ubie-oss/slack-mcp-server

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

node node_modules/.bin/slack-mcp-server

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

{
  "slack": {
    "command": "npx",
    "args": [
      "-y",
      "@ubie-oss/slack-mcp-server"
    ],
    "env": {
      "NPM_CONFIG_//npm.pkg.github.com/:_authToken": "<your-github-pat>",
      "SLACK_BOT_TOKEN": "<your-bot-token>",
      "SLACK_USER_TOKEN": "<your-user-token>"
    }
  }
}

実装パターン

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

Zodスキーマを使用してリクエスト/レスポンスを定義する
- リクエストスキーマ: 入力パラメータを定義する
- レスポンススキーマ: 必要なフィールドに限定したレスポンスを定義する
実装フロー：
- 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 - リンティングの問題を自動的に修正する

貢献

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

Slack MCP Server

Integrations