Slack MCP Host

🚀 Slack MCP 主機

Slack MCP 主機是一款集成 MCP（機器控制協議）服務器與 Slack 的機器人。它藉助 LLM 提供對話體驗，支持在專屬頻道執行工具操作。該機器人能運行配置 MCP 服務器的工具，並以友好格式展示結果。

🚀 快速開始

要使用 Slack MCP 主機，你需要滿足以下先決條件：

• Python 3.11+ 版本
• uv 用於依賴管理
• 帶有管理員權限的 Slack 工作區
• OpenAI API 訪問權限
• 至少一個 MCP 服務器

✨ 主要特性

• 🤖 LLM 驅動的 Slack 對話
• 🔧 多個 MCP 服務器集成
• 📝 Markdown 渲染支持
• 🔍 工具執行結果可摺疊顯示
• 💾 會話歷史維護
• 🔐 安全配置管理

📦 安裝指南

克隆倉庫

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

創建並激活虛擬環境

uv venv
source .venv/bin/activate  # Windows系統請使用：.venv\Scripts\activate

安裝依賴項

uv sync

配置環境

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

創建 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 授權，詳情請參閱 LICENSE 文件。