Slack MCP Host

Slack MCP Host

一个 Slack 机器人，可将 MCP（Machine Control Protocol）服务与 Slack 集成，并在专用频道中提供由大模型驱动的交互。该机器人可以执行已配置的 MCP 服务中的工具，并以用户友好的格式呈现结果。

功能

• 🤖 在 Slack 中进行由大模型驱动的对话
• 🔧 集成多个 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  # On 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 Servers
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 App

• 前往 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 App 配置

• 前往 Slack App 设置
• 将 Event Subscription URL 更新为你的 Cloudflare Workers URL： https://slack-mcp-host.<your-worker-subdomain>.workers.dev/slack/events

使用示例

以下是一个交互流程示例：

1. 用户开始对话

User: Can you help me find movies directed by Christopher Nolan?

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

Bot: I'll help you find movies directed by Christopher Nolan using the Neo4j Movies database.

<details><summary>Tool Results</summary>
Tool neo4j_movies result:
- Inception (2010)
- The Dark Knight (2008)
- Interstellar (2014)
- Memento (2000)
- The Prestige (2006)
</details>

Would you like to know more details about any of these movies?

3. 用户继续提问

User: Tell me more about Inception

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

Bot: I'll get the details about Inception for you.

<details><summary>Tool Results</summary>
Tool neo4j_movies result:
Title: Inception (2010)
Director: Christopher Nolan
Cast: Leonardo DiCaprio, Joseph Gordon-Levitt, Ellen Page
Plot: A thief who steals corporate secrets through dream-sharing technology is given the inverse task of planting an idea into the mind of a C.E.O.
</details>

The movie received critical acclaim for its innovative storytelling and visual effects. Would you like to know about any other movies or specific aspects of Inception?

开发

在本地运行以进行开发：

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

使用 ngrok 或类似工具公开本地服务：

ngrok http 8000

使用 ngrok URL 更新 Slack App 的 Event Subscription 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，详情请参阅 LICENSE 文件。