星战科技xingzhan.cloud
返回市场
Slack通知mcp

Slack通知mcp

作者：Zavdielx892 星标更新：2025-06-30
安装使用来源：spider==github.com

项目介绍

🚀 Slack通知MCP服务器

MIT许可证 Node.js版本 MCP兼容 GitHub星标 请我喝杯咖啡

通过即时Slack通知改进您的Claude AI工作流程！

这是一个强大的模型上下文协议（MCP）服务器，它无缝连接Claude AI与Slack，实现任务完成、警报和工作流自动化的实时通知。再也不错过您AI助手的重要更新！

✨ 为什么选择这个MCP服务器？

  • 🤖 Claude集成：专门为Claude AI通过模型上下文协议构建
  • ⚡ 即时通知：当Claude完成任务时获得实时更新
  • 🎯 多通道支持：向不同的Slack频道发送针对性的消息
  • 🎨 丰富的格式化：支持标题、颜色和消息样式
  • 🔧 零配置麻烦：简单的JSON配置即可快速启动
  • 🚀 轻量级：快速的Node.js实现，依赖最少

🛠️ 特性

  • 🚀 根据配置的Slack频道动态创建工具
  • 📱 支持丰富的消息格式化（标题、颜色）
  • ⚡ 快速且轻量级的Node.js实现
  • 🔧 通过JSON文件轻松配置
  • 🎯 每个频道都有独立的工具以实现精确控制

🎯 完美适用于

  • AI工作流自动化：当Claude完成长时间运行的任务时收到通知
  • 开发团队：自动化部署通知和错误警报
  • 数据分析：在数据处理完成后接收更新
  • 内容创作：当Claude完成写作或研究任务时收到警报
  • 系统监控：发送格式化的警报以更新系统状态
  • 项目管理：自动化状态更新到项目频道

🚀 快速开始

# 1. 克隆并安装
git clone https://github.com/Zavdielx89/slack-notification-mcp.git
cd slack-notification-mcp
npm install

# 2. 配置您的Slack网络钩子
cp config.example.json config.json
# 编辑config.json中的网络钩子URL

# 3. 添加到您的Claude Desktop配置
# 查看详细的设置说明

📋 设置

1. 安装依赖

cd ~/code/workflows/Slack-Notification-MCP
npm install

2. 创建Slack网络钩子

对于每个您想要发送通知的Slack频道：

  1. 进入您的Slack工作区
  2. 导航至应用 > 管理 > 自定义集成 > 入站网络钩子
  3. 或访问：https://[您的工作区].slack.com/apps/manage/custom-integrations
  4. 点击添加到Slack
  5. 选择您要发送通知的频道
  6. 复制网络钩子URL

3. 配置频道

在项目目录中创建一个config.json文件：

cp config.example.json config.json

编辑config.json，填入实际的Slack网络钩子URL：

{
  "channels": {
    "general": {
      "name": "通用",
      "webhook_url": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX"
    },
    "notifications": {
      "name": "任务通知",
      "webhook_url": "https://hooks.slack.com/services/T11111111/B11111111/YYYYYYYYYYYYYYYYYYYYYYYY"
    },
    "alerts": {
      "name": "系统警报",
      "webhook_url": "https://hooks.slack.com/services/T22222222/B22222222/ZZZZZZZZZZZZZZZZZZZZZZZZ"
    }
  }
}

4. 添加到MCP设置

将此服务器添加到您的MCP客户端配置（例如，Claude Desktop）：

{
  "mcpServers": {
    "slack-notifications": {
      "command": "node",
      "args": ["/Users/zavdielx/code/workflows/Slack-Notification-MCP/index.js"]
    }
  }
}

5. 重启Claude Desktop

重启您的Claude Desktop应用程序以加载新的MCP服务器。

使用

一旦配置好，您将拥有每个已配置频道的工具。例如，如果您配置了名为“general”、“notifications”和“alerts”的频道，您将看到这些工具：

  • slack_notify_general
  • slack_notify_notifications
  • slack_notify_alerts

基本消息

使用slack_notify_notifications工具发送消息：“任务成功完成！”

带标题的消息

向通用频道发送带有标题“构建完成”和消息“部署顺利完成，无错误”的通知

带颜色的消息

向警报频道发送带有标题“检测到错误”，消息“API端点返回500错误”，以及颜色“危险”的警报

工具参数

每个slack_notify_*工具接受以下参数：

  • message（必需）：主要消息内容
  • title（可选）：出现在消息之前的粗体标题
  • color（可选）：消息侧边栏的颜色
    • "good" - 绿色（成功）
    • "warning" - 黄色（警告）
    • "danger" - 红色（错误）

示例工作流

任务完成通知

在长时间分析完成后，向通知频道发送消息：“数据分析完成。发现数据集中有15个异常。报告准备审核。”

错误警报

如果发生错误，向警报频道发送带有标题“处理错误”和消息“用户上传失败：无效文件格式”的红色警报

状态更新

向通用频道发送带有标题“系统更新”和消息“维护窗口后所有服务正常运行”的绿色消息

开发

在开发模式下运行

npm run dev

这将启动服务器，并监视文件以自动重启。

添加新频道

  1. 为该频道创建一个新的Slack网络钩子
  2. 将频道配置添加到config.json
  3. 重启MCP服务器
  4. 新的slack_notify_[频道ID]工具将自动可用

测试

您可以直接测试服务器：

npm start

服务器将运行并等待从标准输入/输出接收到的MCP协议消息。

故障排除

“未找到配置文件”错误

确保您已在项目目录中创建了具有有效Slack网络钩子URL的config.json文件。

“发送Slack消息失败”错误

  • 验证您的网络钩子URL是否正确
  • 检查Slack网络钩子是否仍然活跃
  • 确保频道在您的Slack工作区中仍然存在

工具未出现在Claude

  • 验证Claude配置中的MCP服务器路径
  • 在进行配置更改后重启Claude Desktop
  • 确保已安装并可访问Node.js

安全注意事项

  • 保护好config.json文件，不要将网络钩子URL提交到版本控制系统
  • 网络钩子URL提供直接发布到您的Slack频道的权限
  • 考虑在生产环境中使用环境变量来存储网络钩子URL

🤝 贡献

欢迎贡献！您可以自由地：

  • 🐛 通过GitHub问题报告错误或请求功能
  • 🔀 提交改进的拉取请求
  • ⭐ 如果您觉得有用，请给仓库点赞
  • 📢 分享给可能受益的其他人

☕ 支持此项目

如果这个MCP服务器为您节省时间或增强了您的Claude AI工作流程，请考虑支持其开发：

请我喝杯咖啡

您的支持帮助我：

  • 🚀 添加新特性和改进
  • 🐛 修复错误并提供支持
  • 📚 创造更好的文档
  • 🎯 为社区构建更多有用的MCP服务器

🔗 相关项目

📈 统计

GitHub仓库大小 GitHub最后一次提交 GitHub问题

由❤️为Claude AI社区制作

如果这个项目有助于您与AI工作流程保持联系，请考虑给它一个⭐！

许可证

MIT许可证 - 随意使用和修改！