Cursor Sound Notifications

🚀 游标声音 MCP

游标声音 MCP 是一个基于模型上下文协议（MCP）的实现方案，当 Cursor AI 完成代码生成后，它能播放音效。该方案与游标深度集成，为开发者带来更具互动性的编码体验，提供独特的音频反馈。

本项目灵感源自 @EricListin 在 X.com 的分享。为避免错误并确保其能在线运行，我对代码做了一些修改。

🚀 快速开始

将以下内容添加到您的游标自定义指令中： "每次你完成任何任务或需要从我这里获取东西时，运行声音 - MCP 服务器以获得我的注意。"

✨ 主要特性

• 🎵 当 Cursor 完成代码生成时，自动播放音效。
• 🛠️ 使用模型上下文协议（MCP），实现标准化集成。
• ⚙️ 支持可配置的声音效果，满足个性化需求。
• 🐞 具备改进的错误处理和日志记录功能，保障运行稳定。
• 📄 采用稳定的 JSON 响应格式。

📦 安装指南

1. 安装依赖项：

npm install

2. 添加您的音效文件： 将您的音效文件放入 sounds 目录中。默认预期的声音文件是：

• sounds/completion.mp3 - 代码生成完成后播放 您可以在 freesound.org 找到免费的音效。

3. 构建项目：

npm run build

💻 使用示例

基础用法

运行 MCP 服务器：

npm start

服务器将启动并监听通过 stdio 运输从 Cursor 发出的事件。

📚 详细文档

配置

声音效果和音量可以通过以下方式自定义：

1. 替换 sounds 目录中的音效文件。
2. 修改 src/index.ts 中的声音文件路径。

开发

对于带有自动重新编译的功能开发：

npm run dev