返回 MCP 目录
public公开dns本地运行

sound-mcp

Cursor AI代码生成后播放音效的MCP实现

article

README

🚀 游标的音效 MCP

本项目是一个 Model Context Protocol (MCP) 实现,可在 Cursor AI 完成代码生成后播放声音效果。它与 Cursor 集成,为开发者带来更具互动性的编码体验。

🚀 快速开始

运行 MCP 服务器:

npm start

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

✨ 主要特性

  • 在 Cursor 完成代码生成后播放声音效果
  • 使用 Model Context Protocol (MCP) 进行标准化集成
  • 可配置的声音效果

📦 安装指南

  1. 安装依赖:
npm install
  1. 添加您的音效文件: 将您的声音文件放在 sounds 文件夹中。默认预期的音效文件为:
  • sounds/completion.mp3 - 在代码生成完成后播放 您可以在 freesound.org 上找到免费的声音效果。
  1. 构建项目:
npm run build

💻 使用示例

基础用法

运行 MCP 服务器:

npm start

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

开发时使用

用于开发时自动重新编译:

npm run dev

🔧 技术细节

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

  1. 替换 sounds 文件夹中的声音文件
  2. 修改 src/index.ts 中的声音文件路径
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端