Ai Notify MCP
About
Receive system notifications in your code editor when an AI response is complete.
Details
- Author
- zhiyingzzhou
- Categories
- Developer Tools, Other, Productivity
Jump to
Setup
Install Ai Notify MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/zhiyingzzhou/ai-notify-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
🎯 为支持 MCP 协议的 AI 代码编辑器设计的智能通知服务器,当 AI 完成回答时自动发送系统通知,提升编程体验。
- 智能标题:自动显示当前项目名称
- 灵活内容:支持自定义通知消息
- 图标定制:支持自定义通知图标
- 音效控制:可开启/关闭提示音
# Ubuntu/Debian sudo apt-get install libnotify-bin # CentOS/RHEL/Fedora sudo dnf install libnotify # 或 yum install libnotify # Arch Linux sudo pacman -S libnotify # openSUSE sudo zypper install libnotify-tools
git clone https://github.com/zhiyingzzhou/ai-notify-mcp.git cd ai-notify-mcp
{ "mcpServers": { "ai-notify": { "command": "node", "args": ["/绝对路径/ai-notify-mcp/dist/index.js"], "autoRun": true } } }
在Cursor Settings→Rules→User Rules中添加:
When responding to user requests, use the ai-notify MCP tool (auto_notify_completion) only as the final step after you have fully completed your answer. Never call this tool during thinking phases, tool calls, or before your answer is complete. The notification should only be triggered when the entire response is ready for the user.
- 打开Cursor Settings→Features→Chat
- 勾选Enable auto-run mode
- 重启 Cursor
{ "notification": { "sound": true, "icon": "./assets/icon.png", "defaultTitle": "Cursor AI", "defaultMessage": "回答完成" } }
# 开发模式(热重载) npm run dev # 构建项目 npm run build # 启动服务 npm start # 类型检查 npm run type-check
ai-notify-mcp/ ├── 📁 src/ │ └── 📄 index.ts # 主入口文件 ├── 📁 dist/ # 构建输出 ├── 📁 assets/ # 资源文件 │ ├── 🖼️ icon.png # 默认图标 │ └── 🖼️ cursor-auto-run.jpg # 配置截图 ├── 📄 package.json # 项目配置 ├── 📄 tsconfig.json # TypeScript 配置 └── 📄 README.md # 项目文档
// 自定义通知处理器示例 import { NotificationHandler } from './types'; const customHandler: NotificationHandler = { async show(options) { // 你的自定义逻辑 console.log(显示通知: ${options.title}); } };
- ✅ 确认 Auto-Run 模式已开启
- ✅ 检查 MCP 配置路径是否正确
- ✅ 确认服务已成功启动
- ✅ 检查系统通知权限设置
- ✅ 验证 AI 助手规则是否正确配置
# 检查进程是否运行 ps aux | grep "ai-notify" # 手动测试通知 node dist/index.js test # 查看 MCP 服务状态 curl -X POST http://localhost:3000/test
# 1. 安装必要依赖 sudo apt-get install libnotify-bin # 2. 测试系统通知 notify-send "测试" "通知功能正常" # 3. 检查 D-Bus 服务 systemctl --user status dbus # 4. 检查通知守护进程 ps aux | grep notification
file ./assets/icon.png identify ./assets/icon.png # 需要 ImageMagick
{ "notification": { "icon": "/Users/username/ai-notify-mcp/assets/icon.png" } }
ls -la dist/ cat dist/index.js | head -10
# 启用所有调试信息 DEBUG=* npm start # 仅查看通知相关日志 DEBUG=mcp:notification npm start # 保存日志到文件 DEBUG=mcp:notification npm start 2>&1 | tee debug.log
echo "OS: $(uname -a)" echo "Node: $(node --version)" echo "npm: $(npm --version)"
# Fork 并克隆项目 git clone https://github.com/your-username/ai-notify-mcp.git cd ai-notify-mcp # 安装依赖 npm install
git checkout -b feature/amazing-feature # 或者修复分支 git checkout -b fix/issue-123
npm run dev # 开发模式(热重载) npm run test # 运行测试 npm run lint # 代码检查 npm run build # 构建验证
# 使用约定式提交 git commit -m "feat: add amazing feature" git commit -m "fix: resolve notification issue" git commit -m "docs: update installation guide" git push origin feature/amazing-feature
- 🔍提交前:确保所有测试通过
- 📚文档:为复杂功能添加说明
- 🧪测试:编写单元测试和集成测试
- 🎨代码:保持代码简洁易读
- 💬沟通:有疑问及时在 Issue 中讨论
- 🏛️MCP 协议团队- 提供优秀的协议标准
- 🌍开源社区- 提供宝贵的反馈和贡献
- 👥所有贡献者- 让这个项目变得更好
- 💻编辑器开发团队- 支持 MCP 协议的实现
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Caches large tool responses to files and returns compact resource links to save LLM context window space.
A VS Code extension with a GUI for the agentic-tools-mcp server, enhancing task and memory management.
Provides utility functions for common tasks like text processing, encoding, decoding, hashing, and system information.
Hebbian memory for AI agents — learns file access patterns, builds neural pathways, predicts next tools/files, saves tokens
Paid remote MCP for AI browser purchase approval checks, spend thresholds, merchant evidence, risk notes, and audit receipts.
Breaking Change Alerts for Humans and AI Agents.
Export and organize Claude Code conversations with powerful filtering. Supports CLI and MCP server integration for Claude Desktop.
Zero-config session continuity for Claude Code. Auto-captures context via Claude Hooks, provides 24 tools for memory, tasks, solutions, and knowledge graph. Multilingual semantic search (94+ languages).
Cross-platform MCP server for system clipboard access. Three tools: get_clipboard, set_clipboard, watch_clipboard. Single Rust binary, zero runtime deps.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





