Slack MCP Server

🚀 slack-mcp-server

このサーバーは、MCP（モデルコンテキストプロトコル）を使用してSlack APIにアクセスするためのものです。AIアシスタントが標準化されたインターフェースを通じてSlack APIとやり取りできるようになります。

✨ 主な機能

利用可能なツール：

• slack_list_channels - ワークスペース内の公共チャンネルをリスト表示し、ページングに対応
• slack_post_message - Slackチャンネルに新しいメッセージを送信
• slack_reply_to_thread - 特定のメッセージスレッドに返信
• 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 Registryにホストされているため、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

クライアント設定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>"
    }
  }
}

🔧 技術詳細

このサーバーは以下の実装パターンを採用しています：

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. Pull Requestを作成する