MCP Slack

🚀 Slack用MCPサーバー

このプロジェクトは、AIアシスタントをSlackワークスペースに統合するためのModel Context Protocol (MCP) サーバーの実装です。AIアシスタントがSlackワークスペースとやり取りできるようになり、様々な操作を行うことが可能です。

🚀 クイックスタート

このMCPサーバーを使用することで、AIアシスタントがSlackワークスペースとやり取りできるようになります。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• チャンネルの一覧表示と閲覧
• チャンネルへのメッセージ送信
• スレッドへの返信
• メッセージへのリアクション追加
• チャンネルの履歴取得
• スレッドの返信取得
• ユーザーの一覧表示とユーザープロファイルの取得

📦 インストール

# npmからインストール
npm install shouting-mcp-slack

# またはグローバルにインストール
npm install -g shouting-mcp-slack

このパッケージはnpmで見つけることができます：shouting-mcp-slack

📚 ドキュメント

前提条件

以下の手順でSlackボットを設定し、必要な認証情報を取得する必要があります。

1. Slack APIコンソール でSlackアプリを作成します。
2. 以下のBot Token権限スコープを追加します：
   • channels:history
   • channels:read
   • chat:write
   • reactions:write
   • users:read
   • users:read.email
3. アプリをあなたのワークスペースにインストールします。
4. Bot User OAuth Tokenをコピーします。

設定

サーバーには以下の環境変数が必要です：

• SLACK_BOT_TOKEN：あなたのSlack Bot User OAuth Token
• SLACK_TEAM_ID：あなたのSlackチームID

使用方法

基本的な使用法

CLIツールとして実行

# 環境変数を設定
export SLACK_BOT_TOKEN=xoxb-your-token
export SLACK_TEAM_ID=your-team-id

# サーバーを実行
mcp-server-slack

あなたのコードで使用

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { SlackClient } from "shouting-mcp-slack";

// サーバーとクライアントを初期化
const server = new Server({...});
const slackClient = new SlackClient(process.env.SLACK_BOT_TOKEN);

// カスタムハンドラーを登録
// ...

利用可能なツール

サーバーは以下のSlack統合ツールを提供します：

• 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：ユーザーのプロファイルを取得

📄 ライセンス

ISC

作者

shouting.hsiao@gmail.com

リポジトリ

https://github.com/z9905080/mcp-slack