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 文件。