🚀 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
- 安装 Wrangler
npm install -g wrangler
- 登录 Cloudflare
wrangler login
- 设置秘密
wrangler secret put SLACK_API_KEY
wrangler secret put OPENAI_API_KEY
- 部署
wrangler deploy
- 更新 Slack 应用配置
- 访问你的 Slack 应用设置
- 更新 Cloudflare Workers 配置，指定
slask-mcp-worker作为主要服务，并设置相应的路由和域名
💻 使用示例
基础用法
操作指南
- 初始化项目
git clone https://github.com/yourusername/slack-mcp-host.git
cd slack-mcp-host
- 安装依赖并启动应用
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 # 依赖管理文件
贡献指南
- 克隆仓库
git clone https://github.com/yourusername/slack-mcp-host.git
- 创建分支并提交更改
git checkout -b feature/new-feature
# 进行代码修改
git add .
git commit -m "添加新功能"
- 推送至 GitHub
git push origin feature/new-feature
- 创建拉取请求
📄 许可证
本项目根据 MIT License 授权，详情请参阅 LICENSE 文件。