Slack MCP Server Sse

🚀 SlackベースのMCPサーバーとSSE伝送

Model Context Protocol（MCP）サーバーで、Slack APIを統合し、Server-Sent Events（SSE）伝送プロトコルを使用しています。このサーバーは、AIアシスタントが簡単なHTTPインターフェースを通じてSlackワークスペースとやり取りできるようにします。

✨ 主な機能

• SSE伝送：stdioではなく、サーバー送信イベント（SSE）を使用し、HTTP/HTTPSで通信できます。
• Slack API統合：Slack APIの主要な機能にアクセスできます。
• シンプルなWebインターフェース：基本的なWebインターフェースとヘルスチェックエンドポイントがあります。
• Docker対応：完全にコンテナ化されており、Dockerを使って簡単にデプロイできます。
• TypeScriptで実装：TypeScriptで記述されており、型安全性と良好な開発体験を提供します。
• クロスプラットフォーム互換性：SSE伝送をサポートするすべてのMCPクライアントで動作します。

📋 前提条件

• Node.js 18以上
• 適切な権限を持つSlackボットトークン
• SlackチームID
• Docker（コンテナ化デプロイ用、オプション）

📦 環境変数

🛠️ セットアップ手順

SlackボットトークンとチームIDの取得

1. Slackアプリを作成します：

   • Slackアプリケーションページにアクセスします。
   • 「新しいアプリを作成」をクリックします。
   • アプリ情報を入力して送信します。

2. アプリにボットユーザーを追加します：

   • アプリの設定ページに移動します。
   • 「ボット」セクションに移動します。
   • ボットユーザーを有効にし、トークン（BOT_TOKENと表示）を取得します。

3. チームIDを取得します：

   • Slackで、あなたのワークスペースURLを見つけます。
   • チームIDはURLに含まれており、TXXXXXXの形式です。

サーバーのデプロイ

1. このリポジトリをローカルマシンにクローンします。
2. 依存関係をインストールします（npmを使用する場合）：npm install
3. サーバーを起動します：node index.js

💻 サーバーへの接続

SSEをサポートする任意のクライアントを使用してサーバーに接続できます。例えば、curlを使用する場合は以下のようにします：

curl http://localhost:3000/sse

🔍 機能の詳細

サポートされる操作

• slack SendMessage
• slack GetChannelHistory
• slack GetUserProfile
• slack GetUsers

💻 使用例

const eventSource = new EventSource('http://localhost:3000/sse');

eventSource.onopen = () => {
  console.log('SSEサーバーに接続しました');
};

eventSource.onmessage = (event) => {
  console.log('メッセージを受信しました:', event.data);
  try {
    const data = JSON.parse(event.data);
    console.log('データを解析しました:', data);
  } catch (error) {
    console.log('生のメッセージ（JSONではない）:', event.data);
  }
};

eventSource.onerror = (error) => {
  console.error('SSE接続エラー:', error);
  eventSource.close();
};

📄 ライセンス

MIT