README
🚀 MCP 通知服务器
MCP 通知服务器是一个借助 node - notifier 来提供系统通知功能的 Model Context Protocol (MCP) 服务器,能为不同平台提供多样化的通知方式。
✨ 主要特性
该服务器提供了多种通知工具,可根据不同的操作系统和使用场景进行选择,支持自定义通知的标题、内容、声音等参数。
📦 安装指南
开发环境安装
- 安装依赖项:
npm install
- 构建项目:
npm run build
- 启动服务器:
npm start
使用 VS Code 安装
- 快速安装:使用 README 顶部的其中一个一键安装按钮。
- 手动安装:将以下 JSON 块添加到您的用户设置(JSON)文件中。可以通过按下
Ctrl + Shift + P并输入Preferences: Open User Settings (JSON)来完成。可选地,您可以在工作区中创建一个名为.vscode/settings.json的文件来使用它。
{
"mcp.servers": {
"notify": {
"command": "npx",
"args": ["mcp-notify"]
}
}
}
Claude 手动安装
将 MCP Notify 服务器条目添加到您的 Claude 设置中以自动使用它。
npx -y @smithery/cli install @burkeholland/mcp-notify --client claude
📚 详细文档
工具说明
show - notification
显示系统通知,使用当前平台的默认 notifier。
所有通知工具的通用参数:
| 属性 | 详情 |
|------|------|
| title | 通知标题 |
| message | 通知内容 |
| sound(可选) | 播放声音(默认:false) |
| wait(可选) | 等待用户操作后移除通知(默认:false) |
| icon(可选) | 图标文件路径(.ico、.png、.jpg 或平台特定) |
| timeout(可选) | 通知过期前的时间(以秒为单位,Linux/Windows) |
show - notification - macos
使用 macOS Notification Center 显示通知。
额外参数:
| 属性 | 详情 |
|------|------|
| actions | 操作按钮标签数组 |
| closeLabel | 关闭通知的标签 |
| dropdownLabel | 下拉菜单的标签 |
| reply | 启用回复功能 |
show - notification - linux
使用 Linux notify - send 显示通知。
额外参数:
| 属性 | 详情 |
|------|------|
| urgency | 通知紧急程度("low", "normal", "critical") |
| category | 通知类别 |
| hint | 通知显示提示 |
| app - name | 应用程序名称 |
show - notification - windows - toast
使用 Windows Toast 通知(适用于 Windows 8+)显示通知。
额外参数:
| 属性 | 详情 |
|------|------|
| appID | 应用程序标识符 |
| shortcutPath | 通知的快捷方式文件路径 |
| install | 通知单击时的安装程序路径 |
show - notification - windows - balloon
使用 Windows Balloon 通知(适用于 Windows 7 及更早版本)显示通知。
额外参数:
| 属性 | 详情 |
|------|------|
| type | 通知类型("info", "warn", "error") |
show - notification - growl
使用 Growl 显示通知。
额外参数:
| 属性 | 详情 |
|------|------|
| name | Growl 应用程序名称 |
| host | Growl 服务器主机 |
| port | Growl 服务器端口 |
| sticky | 保持通知可见 |
| label | 通知标签 |
| priority | 通知优先级(-2 到 2) |
| sender | 通知发送者 |
微信扫一扫