Soundza 是一个免费的音效、音乐循环与氛围声音库，提供托管 MCP 服务器和 REST API 两种访问方式。所有声音均可免费用于个人和商业项目，无需署名。该技能旨在让智能体协助用户为游戏、视频或应用查找、试听并添加音效，或在无合适库声音时根据提示生成新的音效。
用途：适用于需要音效（SFX）、UI 声音、转场呼啸声、氛围声或背景音乐的场景；也适用于给按钮、拾取、错误或剪辑添加音频反馈，或当没有库声音匹配时生成短音效。不适用于语音、旁白或带人声的完整歌曲。
主要能力：
- 通过 MCP（Streamable HTTP）或 REST API 搜索声音库。
- 支持按事件、类型、时长、情绪、循环、BPM、调性等条件过滤。
- 提供免费预览链接供用户试听。
- 支持下载用户选中的声音，下载链接有效期 15 分钟。
- 当库中无合适声音时，可根据提示生成新的音效或短氛围声。
使用方式：
- 连接：MCP 地址为 https://mcp.soundza.com/mcp/oauth，需在浏览器中免费登录；Claude Code 中可使用命令 claude mcp add --transport http soundza https://mcp.soundza.com/mcp/oauth，然后通过 /mcp 登录。REST 基础 URL 为 https://api.soundza.com/v1，需设置 Authorization: Bearer $SOUNDZA_API_KEY；搜索无需密钥，下载和生成需要。密钥应保存在项目的 .env 中，确保 .env 被 gitignore，切勿提交或打印。
- 列出项目所需声音：先阅读项目，为每个声音槽位绑定代码或时间线中的具体时刻，如游戏中的按钮点击、金币拾取、跳跃、受伤、升级、游戏结束、氛围、背景音乐；视频中的每次剪辑呼啸声、标题冲击声、上升音效、音乐床；应用中的点击、切换、成功、错误、通知。若列表较长，需与用户确认。
- 每个槽位搜索一次：调用 search_sounds（或 GET /v1/sounds/search），在 q 中传入事件，并酌情添加 type 和时长限制，例如 {"q": "coin pickup", "type": "sound_effect", "max_duration": 2} 或 {"q": "rain at night", "type": "ambience", "min_duration": 30}。其他过滤条件包括 mood、form: "loop"、loop_seamless、min_bpm / max_bpm 和 key。
- 让用户挑选：每个槽位展示三到五个结果，包括标题、长度和 listen_url 供试听。预览免费。可推荐一个并简要说明理由。
- 仅下载用户选中的声音：对每个选中声音调用 download_sound 一次，返回链接有效期 15 分钟。将文件保存到项目资源文件夹，并使用能说明用途的名称（如 public/sounds/coin.wav）。不要下载备选或批量下载整个库。
- 无合适声音时生成：调用 generate_sound（或 POST /v1/generations），提供具体提示，例如 {"prompt": "retro 8-bit coin pickup", "duration_seconds": 1, "takes": 3}。播放各 take 的 preview_urls 供用户试听，保存用户选中的那个，并告知其为 AI 生成。
适用场景：游戏开发添加音效、视频剪辑添加转场与氛围声、应用 UI 音频反馈、需要短音效但库中无匹配时生成。
限制：
- 下载和生成需要免费的 Soundza 账户；搜索和预览无需账户。
- 生成仅支持音效和最长 10 秒的短氛围声，不支持音乐或语音；每个账户每周免费 250 次，一次一个任务。
- 遇到速率限制错误时，需等待指定时间并告知用户。
- 声音不得用于训练 AI 模型，不得单独转售或未经修改再分发。
- 技能需要访问 https://mcp.soundza.com 或 https://api.soundza.com 的网络权限。
资源：开发者文档 https://soundza.com/developers；智能体文档 https://soundza.com/llms.txt；技能与 MCP 服务器 https://github.com/soundza/soundza-mcp。