{"_id":"@6starlong/mcp-server-notify","_rev":"15-f1e7c986503736b86546f73db52a891b","name":"@6starlong/mcp-server-notify","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.1":{"name":"@6starlong/mcp-server-notify","version":"0.1.1","keywords":["notification","mcp","mcp-server","agent","cli"],"author":{"name":"6starlong"},"license":"MIT","_id":"@6starlong/mcp-server-notify@0.1.1","maintainers":[{"name":"6starlong","email":"starlong.lu@gmail.com"}],"homepage":"https://github.com/6starlong/mcp-server-notify#readme","bugs":{"url":"https://github.com/6starlong/mcp-server-notify/issues"},"bin":{"mcp-notify":"dist/index.js"},"dist":{"shasum":"990735acee56ad7399a40646c936a3d23eec90c7","tarball":"https://registry.npmjs.org/@6starlong/mcp-server-notify/-/mcp-server-notify-0.1.1.tgz","fileCount":8,"integrity":"sha512-eNZ90tnATdJjfCsbkNjzejwO4udS0M8fT0T3GZCeYDsBLNwi64zrBoaPOA47KEqX556N1Q1+A2DsD5SFM3SIsg==","signatures":[{"sig":"MEQCIDo2989bTKp+Thb5c+1yOhsm9487D0mkKwP+fVMejblLAiAH6vvrG3/xr/Eb7FhowN0svXUprKp5L8/Gvy3tmfmvnw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":43626},"main":"dist/index.js","engines":{"node":">=22.0.0"},"gitHead":"62e635da99e4b72bcc52900453dc668f4afbfadb","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","prepare":"pnpm run build"},"_npmUser":{"name":"6starlong","email":"starlong.lu@gmail.com"},"repository":{"url":"git+https://github.com/6starlong/mcp-server-notify.git","type":"git"},"_npmVersion":"11.4.2","description":"一个简单轻量的用于 Agent 任务完成后发送系统桌面原生通知的 Model Context Protocol (MCP) 服务。","directories":{},"_nodeVersion":"24.4.1","dependencies":{"sound-play":"^1.1.0","node-notifier":"^10.0.1"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.13","@types/sound-play":"^1.1.3","@types/node-notifier":"^8.0.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-notify_0.1.1_1753374879339_0.5138995542336993","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@6starlong/mcp-server-notify","version":"0.1.2","keywords":["notification","mcp","mcp-server","agent","cli"],"author":{"name":"6Starlong"},"license":"MIT","_id":"@6starlong/mcp-server-notify@0.1.2","maintainers":[{"name":"6starlong","email":"starlong.lu@gmail.com"}],"homepage":"https://github.com/6starlong/mcp-server-notify#readme","bugs":{"url":"https://github.com/6starlong/mcp-server-notify/issues"},"bin":{"mcp-notify":"dist/index.js"},"dist":{"shasum":"130e17d64b9f976c3d2f0eaceae1dfaacee73455","tarball":"https://registry.npmjs.org/@6starlong/mcp-server-notify/-/mcp-server-notify-0.1.2.tgz","fileCount":9,"integrity":"sha512-FcPsk2eUHA4ZqJsxKxOGenSNWx9LyFmb0dwBTcZgfJYZgbL+W6i7fae3RV9VHhkYYUBY3jD/w/IjdMXIW8NvYg==","signatures":[{"sig":"MEUCIQCWYyNw6ufxjQgRgvCUJDyAKpM0uX2NKfRcgz9FzpK5igIgIGV16bwJoD3mK5jDwAogRX5YhUT5gVRr3y2/6uUkfqI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54374},"main":"dist/index.js","engines":{"node":">=22.0.0"},"gitHead":"0267309b759557c9fd8fc2b5f03c614feb5176e4","scripts":{"dev":"tsx src/index.ts","test":"pnpm run build && tsx test/notify.test.ts","build":"tsc","start":"node dist/index.js","dev:cli":"tsx src/cli.ts","dev:mcp":"tsx src/mcp-server.ts","test:cli":"pnpm run build && tsx test/cli.test.ts","test:mcp":"pnpm run build && tsx test/mcp.test.ts"},"_npmUser":{"name":"6starlong","email":"starlong.lu@gmail.com"},"repository":{"url":"git+https://github.com/6starlong/mcp-server-notify.git","type":"git"},"_npmVersion":"11.4.2","description":"一个简单轻量的用于 Agent 任务完成后发送系统桌面原生通知的 Model Context Protocol (MCP) 服务。","directories":{},"_nodeVersion":"24.4.1","dependencies":{"sound-play":"^1.1.0","node-notifier":"^10.0.1"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.13","@types/sound-play":"^1.1.3","@types/node-notifier":"^8.0.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-notify_0.1.2_1753416033464_0.5495188632303534","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@6starlong/mcp-server-notify","version":"0.1.3","keywords":["notification","windows","agent","mcp"],"author":{"name":"6Starlong"},"license":"MIT","_id":"@6starlong/mcp-server-notify@0.1.3","maintainers":[{"name":"6starlong","email":"starlong.lu@gmail.com"}],"homepage":"https://github.com/6starlong/mcp-server-notify#readme","bugs":{"url":"https://github.com/6starlong/mcp-server-notify/issues"},"bin":{"mcp-notify":"dist/index.js"},"dist":{"shasum":"32af75c5911b2044fe55b69815b89a90093712f7","tarball":"https://registry.npmjs.org/@6starlong/mcp-server-notify/-/mcp-server-notify-0.1.3.tgz","fileCount":9,"integrity":"sha512-MBZZHrZsli+M+b5u6SbFLSv7Gw8j5QWAzitoqgFLQTaZ90J0AmuADfRiLCTdCTjduMj+DcBZMWEzQaIR+hcoUw==","signatures":[{"sig":"MEUCIQDmheIxTu3opuCmgD6XO30tsD1wRXBtBXSWK10U5Y9joQIgQUgG937xGc5ds3avxd9oRuQekT9/JhBYecsVDySt6d8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53370},"main":"dist/index.js","engines":{"node":">=22.0.0"},"gitHead":"ad9a8ba085aa30cd22fad32d36fa0917c6913f4a","scripts":{"dev":"tsx src/index.ts","test":"pnpm run build && tsx test/notify.test.ts","build":"tsc","start":"node dist/index.js","dev:cli":"tsx src/cli.ts","dev:mcp":"tsx src/mcp-server.ts","test:cli":"pnpm run build && tsx test/cli.test.ts","test:mcp":"pnpm run build && tsx test/mcp.test.ts"},"_npmUser":{"name":"6starlong","email":"starlong.lu@gmail.com"},"repository":{"url":"git+https://github.com/6starlong/mcp-server-notify.git","type":"git"},"_npmVersion":"11.4.2","description":"一个轻量级的桌面通知工具，支持命令行直接调用和 MCP 协议集成，让 AI 助手能够智能发送系统通知。","directories":{},"_nodeVersion":"24.4.1","dependencies":{"sound-play":"^1.1.0","node-notifier":"^10.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.13","@types/sound-play":"^1.1.3","@types/node-notifier":"^8.0.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-notify_0.1.3_1753417295774_0.41691941258664555","host":"s3://npm-registry-packages-npm-production"}},"0.1.4-1":{"name":"@6starlong/mcp-server-notify","version":"0.1.4-1","keywords":["notification","windows","agent","mcp"],"author":{"name":"6starlong"},"license":"MIT","_id":"@6starlong/mcp-server-notify@0.1.4-1","maintainers":[{"name":"6starlong","email":"starlong.lu@gmail.com"}],"homepage":"https://github.com/6starlong/mcp-server-notify#readme","bugs":{"url":"https://github.com/6starlong/mcp-server-notify/issues"},"bin":{"mcp-notify":"dist/index.js"},"dist":{"shasum":"bfb46b0626cf753adc89abea8f1b2ae7a4707a4a","tarball":"https://registry.npmjs.org/@6starlong/mcp-server-notify/-/mcp-server-notify-0.1.4-1.tgz","fileCount":10,"integrity":"sha512-Q/7Q/vyuaniOiba8/zvyxTR84JH8xQL3ZCVMdEYeED5xwMRqALLllWhiKknJa7kY5WPpU1h8ozJexNxbVGaWRg==","signatures":[{"sig":"MEUCIQCKgAJEczqvofNq1CIjiJQffiI2eUOBd+UvIjMGFHs1VAIgbSPql00o5zNUsmRO143a+0cwSa463orQhlkU4XOftWI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53811},"main":"dist/index.js","engines":{"node":">=22.0.0"},"gitHead":"faa95c9dcad6fd4004dd55216581a048751a89ba","scripts":{"dev":"tsx src/index.ts","test":"pnpm run build && tsx test/notify.test.ts","build":"tsc","start":"node dist/index.js","dev:cli":"tsx src/cli.ts","dev:mcp":"tsx src/mcp-server.ts","test:cli":"pnpm run build && tsx test/cli.test.ts","test:mcp":"pnpm run build && tsx test/mcp.test.ts"},"_npmUser":{"name":"6starlong","email":"starlong.lu@gmail.com"},"repository":{"url":"git+https://github.com/6starlong/mcp-server-notify.git","type":"git"},"_npmVersion":"11.4.2","description":"一个轻量级的桌面通知工具，支持命令行直接调用和 MCP 协议集成，让 AI 助手能够智能发送系统通知。","directories":{},"_nodeVersion":"24.4.1","dependencies":{"sound-play":"^1.1.0","node-notifier":"^10.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.13","@types/sound-play":"^1.1.3","@types/node-notifier":"^8.0.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-notify_0.1.4-1_1753418400682_0.18024426932536985","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@6starlong/mcp-server-notify","version":"0.2.0","keywords":["notification","notify","mcp","server","agent"],"author":{"name":"6starlong"},"license":"MIT","_id":"@6starlong/mcp-server-notify@0.2.0","maintainers":[{"name":"6starlong","email":"starlong.lu@gmail.com"}],"homepage":"https://github.com/6starlong/mcp-server-notify#readme","bugs":{"url":"https://github.com/6starlong/mcp-server-notify/issues"},"bin":{"mcp-notify":"dist/index.js"},"dist":{"shasum":"f7013a78c6be8fae2442968916a32c757caec32b","tarball":"https://registry.npmjs.org/@6starlong/mcp-server-notify/-/mcp-server-notify-0.2.0.tgz","fileCount":9,"integrity":"sha512-8knYGFlLyuacFDj4qX8GOKB1y6VjW5ptuiVMsz7lWQHVDreOU08C5mVzhgK13uXryLnfgyVjuioZIovn6ah67g==","signatures":[{"sig":"MEUCIQDyttfxLGvU3JL1OhpU2/vxGoty2YFm4sFXRzB1CjUmkAIgB6/3mqzzMeOElJxkbMLpCYlH1ISV3Uxt2epr3u1NJ4A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":64812},"main":"dist/index.js","engines":{"node":">=22.0.0"},"gitHead":"82d54c4cb00be214ebdd53de77337dd22aa6a77f","scripts":{"dev":"tsx src/index.ts","test":"tsc && tsx test/notify.test.ts","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"6starlong","email":"starlong.lu@gmail.com"},"repository":{"url":"git+https://github.com/6starlong/mcp-server-notify.git","type":"git"},"_npmVersion":"11.4.2","description":"轻量级桌面通知工具，支持MCP协议集成，让 Agent 能够智能发送系统通知","directories":{},"_nodeVersion":"24.4.1","dependencies":{"open":"^10.2.0","sound-play":"^1.1.0","node-notifier":"^10.0.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^24.0.13","@types/sound-play":"^1.1.3","@types/node-notifier":"^8.0.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-notify_0.2.0_1753423655464_0.02409112707186778","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@6starlong/mcp-server-notify","version":"0.2.1","description":"轻量级桌面通知工具，支持MCP协议集成，让 Agent 能够智能发送系统通知","main":"dist/index.js","bin":{"mcp-notify":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/6starlong/mcp-server-notify.git"},"scripts":{"build":"pnpm tsc","dev":"pnpx tsx src/index.ts","test":"pnpm tsc && pnpx tsx test/notify.test.ts","start":"node dist/index.js"},"keywords":["notification","notify","mcp","server","agent"],"author":{"name":"6starlong"},"license":"MIT","dependencies":{"node-notifier":"^10.0.1","node-wav-player":"^1.0.0","open":"^10.2.0"},"devDependencies":{"@types/node":"^24.0.13","@types/node-notifier":"^8.0.5","typescript":"^5.8.3"},"engines":{"node":">=22.0.0"},"_id":"@6starlong/mcp-server-notify@0.2.1","gitHead":"8f5533802fcf367f1c10a38e74d076169e29e910","bugs":{"url":"https://github.com/6starlong/mcp-server-notify/issues"},"homepage":"https://github.com/6starlong/mcp-server-notify#readme","_nodeVersion":"24.5.0","_npmVersion":"11.5.1","dist":{"integrity":"sha512-/6lTql4nQZKOJfMJ2n9X0aoKmkYUe+jRXEBhnvp9ww+M9bXcnEtUuEAJ9793UXdKxDhl5lDOTZWYbWCAk/5WWw==","shasum":"461f589041f04925b84e20646d6f76076290b2d2","tarball":"https://registry.npmjs.org/@6starlong/mcp-server-notify/-/mcp-server-notify-0.2.1.tgz","fileCount":9,"unpackedSize":224335,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCFG9Ifl0bH8mhtNh1WPaspVykaUORFmqLlgan1UO/TDQIgRzYD3CcDVbOJAV/xeftuLrDuJ64gkZ9BVJL4dxjoczo="}]},"_npmUser":{"name":"6starlong","email":"starlong.lu@gmail.com"},"directories":{},"maintainers":[{"name":"6starlong","email":"starlong.lu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-notify_0.2.1_1756671852156_0.5107360029138956"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-24T13:43:59.454Z","modified":"2025-08-31T20:24:12.618Z","0.1.4":"2025-07-24T13:43:59.731Z","0.1.1":"2025-07-24T16:34:39.563Z","0.1.2":"2025-07-25T04:00:33.675Z","0.1.3":"2025-07-25T04:21:36.015Z","0.1.4-1":"2025-07-25T04:40:00.869Z","0.1.5":"2025-07-25T05:28:33.983Z","0.1.5-fix.1":"2025-07-25T05:38:53.345Z","0.2.0":"2025-07-25T06:07:35.720Z","0.2.1":"2025-08-31T20:24:12.398Z"},"bugs":{"url":"https://github.com/6starlong/mcp-server-notify/issues"},"author":{"name":"6starlong"},"license":"MIT","homepage":"https://github.com/6starlong/mcp-server-notify#readme","keywords":["notification","notify","mcp","server","agent"],"repository":{"type":"git","url":"git+https://github.com/6starlong/mcp-server-notify.git"},"description":"轻量级桌面通知工具，支持MCP协议集成，让 Agent 能够智能发送系统通知","maintainers":[{"name":"6starlong","email":"starlong.lu@gmail.com"}],"readme":"# mcp-server-notify\r\n\r\n一个轻量级的桌面通知工具，支持 MCP 协议集成和命令行直接调用，让 Agent 能够智能发送系统通知。\r\n\r\n## 特性\r\n\r\n- 🔔 发送系统桌面原生通知\r\n- 🤖 完整的 MCP 协议支持，轻松集成各类 Agent 工具\r\n- 🎵 可自定义声音和图标（本地文件或URL）\r\n- 📱 跨平台支持（基于 [node-notifier](https://www.npmjs.com/package/node-notifier)）\r\n- 🎯 支持点击通知后激活指定应用、URL或可执行文件。\r\n- ⚡ 极致轻量，开箱即用，无需复杂配置\r\n\r\n## 使用方法\r\n\r\n### 1. MCP服务\r\n\r\n#### 使用 npm\r\n\r\n集成到 Cursor、Claude Code 或其他支持 MCP 协议的编辑器和 Agent 工具中：\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"notify\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@6starlong/mcp-server-notify\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n#### 使用示例\r\n\r\n配置完成后，您可以通过以下方式触发通知：\r\n\r\n```markdown\r\n- \"任务完成后通知我\"\r\n- \"测试全部通过了，庆祝一下\"\r\n- \"发现安全漏洞，用警告音效和图标通知我\"\r\n- \"通知我代码审核结果，点击时激活 Code\"\r\n- \"帮我设置一个番茄钟，25分钟后提醒我休息\"\r\n```\r\n\r\n你可以通过在 `~/rules/notify.md` 中创建自定义规则来避免每次手动输入这些偏好设置。例如，设置默认的通知样式、常用的声音文件路径、或特定项目的通知行为。\r\n\r\n#### 注意事项\r\n\r\n- **默认设置**：系统使用 [coding.png](./assets/coding.png) 作为默认图标，[done.wav](./assets/done.wav) 作为默认提示音\r\n- **资源管理**：支持本地文件路径和网络URL，网络资源可能有加载延迟，系统会自动降级处理（默认3秒）\r\n- **静音模式**：对于频繁通知，可以指定静音模式避免干扰\r\n- **应用关联**：点击通知后返回原应用（Windows）或打开指定的URL、程序、可执行文件。\r\n\r\n### 2. 命令行使用\r\n\r\n```bash\r\n# 安装\r\nnpm install -g @6starlong/mcp-server-notify\r\n\r\n# 查看帮助\r\nmcp-notify -h\r\n\r\n# 基本通知\r\nmcp-notify -c \"标题\" \"消息内容\"\r\n\r\n# 流程通知\r\nmcp-notify -c \"任务完成\" \"代码编译成功\" --open Code\r\n\r\n# 自动化任务通知\r\nmcp-notify -c \"测试通过\" \"所有单元测试已通过\" --sound C:\\\\Windows\\\\Media\\\\tada.wav\r\n\r\n# 集成到脚本中\r\nnpm run build && mcp-notify -c \"构建成功\" \"可以开始部署了\"\r\n```\r\n\r\n### 3. 编程接口\r\n\r\n```typescript\r\nimport { sendNotification } from '@6starlong/mcp-server-notify'\r\n\r\nawait sendNotification('标题', '消息', {\r\n  icon: './icon.png',      // 本地文件或URL，false禁用\r\n  sound: './sound.wav',    // 本地文件或URL，false禁用\r\n  open: 'Code',            // 点击通知后要激活的应用名称\r\n})\r\n```\r\n\r\n## 开发和测试\r\n\r\n```bash\r\n# 构建项目\r\npnpm run build\r\n\r\n# 测试\r\npnpm test\r\n\r\n# 开发模式（启动MCP服务器）\r\npnpm run dev\r\n```\r\n\r\n## 许可证\r\n\r\nMIT License\r\n\r\n## 贡献\r\n\r\n欢迎提交问题和PR！\r\n","readmeFilename":"README.md"}