Slack MCP Host

🚀 Slack MCP ホスト

このSlackボットは、MCP（マシンコントロールプロトコル）サーバーとSlackを統合し、LLMによる対話体験を提供します。専用チャンネルでのツール操作をサポートし、設定されたMCPサーバーのツールを実行し、結果をユーザーフレンドリーな形式で表示します。

✨ 主な機能

• 🤖 LLM駆動のSlack対話
• 🔧 複数のMCPサーバー統合
• 📝 Markdownレンダリングサポート
• 🔍 ツール実行結果の折りたたみ表示
• 💾 会話履歴の維持
• 🔐 セキュアな設定管理

📦 インストール

前提条件

• Python 3.11以上のバージョン
• uvを使用した依存関係管理
• 管理者権限を持つSlackワークスペース
• OpenAI APIへのアクセス権限
• 少なくとも1つのMCPサーバー

インストールと設定

1. リポジトリをクローン

git clone https://github.com/yourusername/slack-mcp-host.git
cd slack-mcp-host

2. 仮想環境を作成してアクティブ化

uv venv
source .venv/bin/activate  # Windowsの場合は：.venv\Scripts\activate

3. 依存関係をインストール

uv sync

4. 環境を設定

cp .env.example .env

.envファイルを編集し、認証情報を入力します。

SLACK_API_KEY=xoxb-あなたのSlackボットトークン
OPENAI_API_KEY=あなたのOpenAI APIキー
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-4

# MCPサーバー設定
SLACK_MCP_NEO4J_MOVIES=uvx mcp-neo4j-cypher --url neo4j+s://demo.neo4jlabs.com --username movies --password movies
SLACK_MCP_TIME=uvx mcp-server-time

5. Slackアプリを作成

• api.slack.com/appsにアクセス
• 「新しいアプリを作成」→「アプリケーションマニフェストから」をクリック
• ワークスペースを選択
• manifest.ymlファイルの内容をコピーして貼り付け
• アプリを作成し、ワークスペースにインストール

デプロイ

Cloudflare Workers

1. Wranglerをインストール

npm install -g wrangler

2. Cloudflareにログイン

wrangler login

3. シークレットを設定

wrangler secret put SLACK_API_KEY
wrangler secret put OPENAI_API_KEY

4. デプロイ

wrangler deploy

5. Slackアプリの設定を更新

• Slackアプリの設定にアクセス
• Cloudflare Workersの設定を更新し、slask-mcp-workerを主要サービスとして指定し、ルートとドメインを設定

💻 使用例

基本的な使用法

1. プロジェクトを初期化

git clone https://github.com/yourusername/slack-mcp-host.git
cd slack-mcp-host

2. 依存関係をインストールしてアプリを起動

pip install -r requirements.txt
python app.py

会話の例

ユーザー入力

今日の天気を教えて。

システム応答

今日の北京の天気は曇りで、気温は18°Cから25°Cです。他の都市の天気を見ますか？

📚 ドキュメント

コード構造

slack-mcp-host/
├── app.py         # メインプログラムエントリーポイント
├── config/       # 設定フォルダ
│   └── settings.py      # アプリケーション設定
├── workers/      # Cloudflare Workersスクリプト
│   └── worker.js  # ワーカーメインスクリプト
└── requirements.txt    # 依存関係管理ファイル

貢献ガイド

1. リポジトリをクローン

git clone https://github.com/yourusername/slack-mcp-host.git

2. ブランチを作成して変更をコミット

git checkout -b feature/new-feature
# コードを変更
git add .
git commit -m "新機能を追加"

3. GitHubにプッシュ

git push origin feature/new-feature

4. プルリクエストを作成

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。