mcpField
A
audio-playback

audio-playback

github.com/sonilo-ai创意与媒体11771 次安装1 天前更新
代码仓库

关于 audio-playback

Sonilo 的 audio-playback 技能通过系统默认输出设备播放本地音频，适合在生成音频后直接试听。它仅执行本地播放，不发起网络请求。

主要功能

  1. 01播放本地音频文件
  2. 02使用系统默认输出设备
  3. 03支持多种音频格式
  4. 04限制文件访问范围

适用场景

  1. 01试听刚生成的音频
  2. 02播放指定路径中的音频

MCP 相关

通过 Sonilo MCP 服务提供 `play_audio` 工具，接收本地文件路径并播放音频。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/sonilo-ai/skills --skill audio-playback

安装后在 Claude Code 中输入/audio-playback确认已加载。

详细介绍

Sonilo 音频播放

通过系统默认输出设备播放本地音频文件。这是 Sonilo 唯一不会发起网络调用的工具——它只在本地播放，适合在生成内容后立即使用，让用户无需离开对话即可听到结果。

**设置：**只需连接 Sonilo MCP 服务——无需 API 密钥（如果尚未连接该服务，请参阅 setup-api-key）。

快速开始

MCP 工具调用
play_audio(input_file_path="~/Desktop/thunder.m4a")

它没有 REST、Python/JS SDK 或 CLI 等效方式——这是 MCP 服务专属的本地播放功能，完全不是 Sonilo API 调用。如果你通过 SDK 或 CLI 而非 MCP 集成，只需使用你自己的语言或平台通常用于本地音频播放的方式播放已保存的文件。

工具

工具描述
play_audio(input_file_path)通过系统默认扬声器播放本地音频文件。

参数

参数类型说明
input_file_pathstring绝对路径，或相对于 SONILO_MCP_BASE_PATH 的路径。支持 .wav/.mp3/.m4a/.aac/.ogg/.flac。

工作流提示

  • 任何生成工具之后的自然后续操作。 text_to_music、text_to_sfx、video_to_music 等返回已保存路径后，如果用户提出要求（或其措辞暗示需要这样做，例如“播放你刚才制作的内容”），就调用 play_audio 播放同一路径下的文件。
  • **平台播放方式：**macOS 使用 afplay；Linux 播放 .mp3 时优先使用 mpg123，其他格式使用 aplay。Windows 完全没有原生播放器分支，始终回退到 sounddevice/soundfile Python 包；Linux 在未安装 mpg123 或 aplay 时也使用相同的回退方式——此回退方式需要单独安装系统 PortAudio 库（macOS 上运行 brew install portaudio，Debian/Ubuntu 上运行 sudo apt-get install libportaudio2）。此仓库中的其他所有功能均无需 PortAudio。
  • 与其他所有工具一样，此工具遵循相同的文件访问限制：除非设置了 SONILO_MCP_ALLOW_ANY_PATH=true，否则会拒绝访问 SONILO_MCP_BASE_PATH 之外的路径。

错误处理

如果文件不存在、格式不受支持、路径位于受限基础路径之外，或平台上没有可用的播放器（错误信息会指出缺少什么），则会报错。

评论

支持 Markdown