MCP音频播放服务

MCP Make Sound是一个基于Model Context Protocol (MCP)的服务器,专为macOS系统提供全面的音频播放功能。它允许AI助手和其他MCP客户端播放系统声音、文本转语音以及自定义音频文件,为用户提供丰富的音频反馈体验。

  • by nocoo
  • 更新于
在 GitHub 查看 nocoo/mcp-make-sound

使用说明

产品定位

MCP Make Sound是一个专为macOS设计的音频播放服务,通过MCP协议为AI助手和客户端应用提供丰富的音频反馈功能。

核心功能

  • 简单声音方法:预配置的信息、警告和错误提示音
  • 自定义系统声音:播放14种内置macOS系统声音
  • 文本转语音:支持可定制语音的文本转语音功能
  • 文件播放:支持从磁盘播放自定义音频文件
  • 基于TypeScript和MCP SDK构建
  • 轻量级且易于集成

适用场景

  • AI任务完成时的音频反馈
  • 系统通知和警报
  • 文本内容的语音播报
  • 自定义音频提示

工具列表

简单声音方法

play_info_sound

  • 功能:播放信息提示音
  • 参数:无
  • 声音:Glass.aiff

play_warning_sound

  • 功能:播放警告提示音
  • 参数:无
  • 声音:Purr.aiff

play_error_sound

  • 功能:播放错误提示音
  • 参数:无
  • 声音:Sosumi.aiff

高级声音方法

play_sound

  • 功能:播放各种类型的声音,支持自定义参数
  • 参数:
    • type(必需):"system"、"tts"或"file"
    • 根据类型不同有额外参数

使用教程

使用依赖

  • 🍎 macOS(使用afplay和系统声音)
  • 🟢 Node.js 18+
  • 📝 TypeScript

安装教程

  1. 克隆仓库:
git clone <repository-url>
cd mcp-make-sound
  1. 安装依赖:
npm install
  1. 构建项目:
npm run build

调试方式

启动MCP服务器:

npm start

开发模式(自动重载):

npm run dev

停止所有运行的MCP服务器实例:

npm run kill