김팔복TV의 Slack MCP Server 예제

김팔복TVのSlack MCP Serverの例

このリポジトリは、김팔복TVで使用するSlack MCP（Model Context Protocol）Serverのサンプルコードです。Slackワークスペースと連携し、チャンネル／メッセージ／ユーザーに関するさまざまな機能を提供します。

主な機能

• ワークスペースの公開チャンネル、または事前に定義されたチャンネルの一覧を取得
• チャンネルへのメッセージ投稿とスレッドへの返信
• メッセージへの絵文字リアクションの追加
• チャンネルのメッセージ履歴とスレッドの返信を取得
• ワークスペースのユーザー情報とプロフィール情報を取得

インストールとビルド

{
  "mcpServers": {
    "kimpalbok-slack-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "kimpalbok-slack-mcp-server"
      ]
    },
    "env": {
      "SLACK_BOT_TOKEN": "xoxb-...",
      "SLACK_TEAM_ID": "T12345678"
    }
  }
}

環境変数の設定

実行前に、以下の環境変数を必ず設定してください。

• SLACK_BOT_TOKEN：Slackボットトークン（例：xoxb-...）
• SLACK_TEAM_ID：Slackワークスペースのチーム ID（例：T12345678）
• （任意）SLACK_CHANNEL_IDS：事前に定義されたチャンネル ID の一覧（カンマ区切り）

例：

export SLACK_BOT_TOKEN=xoxb-...
export SLACK_TEAM_ID=T12345678
export SLACK_CHANNEL_IDS=C12345678,C23456789

Slackボットの設定

アプリとボットの設定リンク：https://api.slack.com/apps

• 「OAuth & Permissions」メニューで「Bot User OAuth Token」を確認してください。

• 「OAuth & Permissions」メニューの「Scopes」で権限を追加してください。

• SLACK_TEAM_IDの確認方法
  https://apps.slack.com にアクセスし、ブラウザーで実行してください。
  URLの「T...」で始まる文字列がTEAM_IDです。

使用例

サーバーはMCPプロトコルを通じて、さまざまなツールを提供します。
以下は、主な対応ツールとその説明です。

ツール名	説明
slack_list_channels	ワークスペースの公開チャンネル、または事前に定義されたチャンネルの一覧を取得
slack_post_message	チャンネルに新しいメッセージを投稿
slack_reply_to_thread	特定のメッセージのスレッドに返信
slack_add_reaction	メッセージに絵文字リアクションを追加
slack_get_channel_history	チャンネルから最近のメッセージを取得
slack_get_thread_replies	メッセージスレッドのすべての返信を取得
slack_get_users	ワークスペースのすべてのユーザーと基本プロフィール情報を取得
slack_get_user_profile	特定のユーザーの詳細なプロフィール情報を取得

各ツールの入力パラメーターと戻り値については、コードのTool定義とTypeScriptの型を参照してください。

参考

• このサーバーはMCP（Model Context Protocol）ベースのサーバーで、標準入力／出力（stdio）ベースのトランスポートで動作します。
• 実際にSlack APIと連携するには、適切な権限を持つSlackボットトークンが必要です。

---

お問い合わせ：김팔복TV