MCP Slack Notifications

🚀 Slack通知MCP服务器

一个强大的 模型上下文协议（MCP） 将Slack通知带到Claude AI工作流的服务器。非常适合在长时间运行的任务完成、发生错误或需要用户输入时收到通知。

 

✨ 特性

• 📱 丰富的Slack消息：带附件、颜色和字段的格式化邮件
• 🎯 任务完成通知：开发工作流程的专门通知
• 🔧 Webhook配置：使用Slack webhook URL轻松设置
• 🌈 颜色编码状态：成功、错误、警告和信息的视觉指示器
• 🎨 可定制的：频道选择、机器人用户名、表情符号和优先级
• 🚀 零配置：适用于环境变量或运行时配置

🛠️ 工具

send_slack_notification

发送具有完整格式选项的可自定义Slack通知。

参数：

• title （必填）：通知标题
• message （必填）：通知消息
• webhook_url （可选）：Slack webhook URL（如果未全局配置）
• channel （可选）：目标频道（例如#general、@username）
• username （可选）：机器人用户名（默认：“克劳德代码”）
• icon_emoji （可选）：Bot表情符号（默认：“：robot_face:”）
• color （可选）：消息颜色（良好、警告、危险、信息或十六进制）
• priority （可选）：优先级（低、正常、高、紧急）

slack_task_completion_notification

发送具有智能格式的任务完成专用通知。

参数：

• status （必填）： success, error, warning，或 info
• taskType （可选）：任务类型（例如，“构建”、“部署”、“测试”）
• duration （可选）：任务需要多长时间
• summary （可选）：成就简述
• url （可选）：相关URL（例如，localhost开发服务器）
• webhook_url （可选）：Slack webhook URL（如果未全局配置）
• channel （可选）：目标通道

configure_slack_webhook

为会话配置全局Slack webhook设置。

参数：

• webhook_url （必填）：您的Slack webhook URL
• default_channel （可选）：通知的默认通道

🚀 快速开始

1.创建Slack Webhook

1. 转到Slack API：参观 api.slack.com
2. 创建新应用程序：点击“创建新应用”>“从头开始”
3. 配置传入Webhooks:

- 转到侧栏中的“传入Webhooks” - 激活传入的webhooks - 点击“将新Webhook添加到工作区” - 选择您的频道并授权 - 复制webhook URL（以开头 https://hooks.slack.com/services/...)

2.安装

1. 克隆此存储库：

\\\bash 克隆https://github.com/chiuchau-cyril/mcp-slack-notifications.git cd-mcp松弛通知 \\\

1. 安装依赖项：

\\\bash npm安装 \\\

1. 构建项目：

\\\bash npm运行构建 \\\

3.配置

克劳德代码

添加到您的Claude Code MCP配置中：

\\\json { “mcpServers”：{ “松弛通知”：{ “command”：“node”， “args”：\[“/Users/cyril/Documents/git/mcp servers/lack notifications/dist/index.js”\]， “env”：{ “SLACK_WEBHOOK_URL”：https://hooks.slack.com/services/YOUR/WEBHOOK/URL" } } } } \\\

对于克劳德应用程序

添加到您的Claude App MCP设置中：

\\\json { “松弛通知”：{ “command”：“node”， “args”：\[“/Users/cyril/Documents/git/mcp servers/lack notifications/dist/index.js”\]， “env”：{ “SLACK_WEBHOOK_URL”：https://hooks.slack.com/services/YOUR/WEBHOOK/URL" } } } \\\

4.测试

运行测试套件以验证一切正常：

\\\bash node test-slack-notifications.js \\\

📱 使用示例

基本通知

\\\javascript //简单通知 { “标题”：“🎉 任务完成”， “message”：“您的构建已成功完成！”， “channel”：“#开发”， “颜色”：“好” } \\\

开发工作流程

\\\javascript //任务完成情况及详细信息 { “状态”：“成功”， “taskType”：“React Build”， “持续时间”：“2分钟”， “summary”：“已成功编译45个组件”， “url”：“http://localhost:3000", “channel”：“#dev通知” } \\\

错误通知

\\\javascript //高优先级错误 { “标题”：“❌ 构建失败”， “message”：“检测到TypeScript编译错误”， “颜色”：“危险”， “优先级”：“紧急”， “频道”：“#警报” } \\\

配置

\\\javascript //为会话设置webhook { “webhook_url”：https://hooks.slack.com/services/YOUR/WEBHOOK/URL", “default_channel”：“#claude通知” } \\\

🎯 智能通知逻辑

此MCP服务器实现了与macOS版本相同的智能通知定时：

⚠️ 即时通知 （需要用户操作）

• 等待确认的命令(Do you want to proceed?)
• 密码提示
• 需要任何用户输入
• 优先级: urgent 红色

✅ 完工通知 （任务已完成）

• 构建过程已完成
• 测试已完成运行
• 部署已完成
• 颜色：绿色（成功）/红色（错误）/橙色（警告）

🔇 无通知

• 简单查询(ls, pwd)
• 命令仍正常运行
• 快速操作（\<30秒）

🎨 Slack消息功能

颜色编码

• 绿色 (good)：成功，已完成任务
• 橙子 (warning)：警告、部分故障
• 红 (danger)：错误、关键问题
• 蓝色 (info)：信息、状态更新
• 自定义：任何十六进制颜色代码（例如。， #FF5733)

优先级

• 低: #cccccc （灰色）
• 正常: #0099cc （蓝色）
• 高: #ff9500 （橙色）
• 紧急: #ff0000 （红色）

丰富的格式

• 附件：结构化消息布局
• 领域：带短/长显示的键值对
• 时间戳：自动消息定时
• 页脚：“克劳德代码”品牌

🛡️ 需求

• Node.js 18+
• 松弛的工作空间 具有webhook权限
• Internet连接 用于webhook交付

🧪 环境变量

设置这些以便于配置：

\\\bash 导出SLACK_WEBHOOK_URL=“https://hooks.slack.com/services/YOUR/WEBHOOK/URL" 导出SLACK_DEFAULT_CHANNEL=“#claude通知” \\\

📖 克劳德规则集成

对于自动通知行为，请将以下规则添加到您的Claude配置中：

\\\`降价

通过Slack自动通知任务完成

当任务需要超过2分钟或需要用户输入时， 使用适当的工具发送Slack通知。

通知时间：

• 需要用户输入→ 紧急优先立即通知
• 任务完成→ 具有适当状态的结果通知
• 发生错误→ 带有危险颜色的错误通知

\\\`

🔒 安全说明

• Webhook URL包含机密 -保密
• 不提交webhook URL 到版本控制
• 使用环境变量 用于生产部署
• 限制webhook权限 仅限于必要的渠道

🤝 贡献

欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🙋‍♂️ 支持

• 🐛 问题:
• 💬 讨论:
• 📧 电子邮件：企业支持联系人

🔗 相关项目

• macOS通知MCP服务器 -原生macOS通知
• 模型上下文协议 -MCP官方文件

______________________________________________________________________

由以下材料制成❤️ 克劳德人工智能生态系统