Slack MCP 主机

一个将 MCP (机器控制协议) 服务器与 Slack 集成的 Slack 机器人，在专用频道中提供由 LLM 驱动的交互。该机器人可以执行来自配置的 MCP 服务器的工具，并以用户友好的格式呈现结果。

特性

• 🤖 Slack 中由 LLM 驱动的对话
• 🔧 与多个 MCP 服务器集成
• 📝 Markdown 渲染支持
• 🔍 可折叠的工具执行结果
• 💾 会话历史维护
• 🔐 安全的配置管理

前提条件

• Python 3.11+
• uv 用于依赖管理
• 具有管理员权限的 Slack 工作区
• OpenAI API 访问权限
• 一个或多个 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-your-slack-bot-token
OPENAI_API_KEY=your-openai-api-key
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
• 点击 "Create New App" → "From an app manifest"
• 选择您的工作区
• 复制并粘贴 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 应用设置
• 将事件订阅 URL 更新为您的 Cloudflare Workers URL： https://slack-mcp-host.<your-worker-subdomain>.workers.dev/slack/events

使用示例

这是一个交互流程的示例：

1. 用户开始对话

User: 你能帮我找到克里斯托弗·诺兰导演的电影吗？

2. 机器人回复并执行工具

Bot: 我将使用 Neo4j Movies 数据库帮助您找到克里斯托弗·诺兰导演的电影。

<details><summary>工具结果</summary>
Tool neo4j_movies result:
- 盗梦空间 (2010)
- 黑暗骑士 (2008)
- 星际穿越 (2014)
- 记忆碎片 (2000)
- 致命魔术 (2006)
</details>

您想了解有关这些电影的更多详细信息吗？

3. 用户跟进

User: 告诉我更多关于盗梦空间的信息

4. 机器人执行另一个查询

Bot: 我将为您获取有关盗梦空间的详细信息。

<details><summary>工具结果</summary>
Tool neo4j_movies result:
Title: 盗梦空间 (2010)
Director: 克里斯托弗·诺兰
Cast: 莱昂纳多·迪卡普里奥, 约瑟夫·高登-莱维特, 艾伦·佩姬
Plot: 一位通过梦境共享技术窃取公司机密的窃贼被赋予了一项相反的任务，即将一个想法植入一位首席执行官的脑海中。
</details>

这部电影因其创新的故事讲述和视觉效果而广受好评。 您想了解有关其他电影或盗梦空间的具体方面的更多信息吗？

开发

要在本地运行以进行开发：

uvicorn src.api:app --reload --port 8000

使用 ngrok 或类似工具来暴露您的本地服务器：

ngrok http 8000

使用 ngrok URL 更新您的 Slack 应用的事件订阅 URL。

贡献

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。