MCP Play Sound Server

MCP播放声音服务器

为AI代理提供音频播放功能的模型上下文协议（MCP）服务器。此服务器使AI代理能够在编码任务完成时播放声音通知。

⚠️ 早期版本/概念验证 这是目前仅在macOS上测试的早期实现。未来的版本将支持其他平台。

特性

• 音频通知：AI任务完成时播放声音警报
• 默认声音：捆绑通知声音可立即使用
• 自定义音频：支持自定义音频文件（WAV、MP3、FLAC、OGG、M4A）
• 智能回退：如果自定义音频失败，则自动回退到默认声音
• macOS支持：目前在macOS上使用AFPlay和SimpleAudio进行测试

安装和设置

开发设置

1. 克隆并安装:

git clone 
cd play-sound-mcp-server
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e ".[dev]"

1. 配置Claude桌面:

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "play-sound": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/play-sound-mcp-server",
        "run",
        "mcp-server-play-sound"
      ]
    }
  }
}

1. 测试：重新启动Claude Desktop并询问：“您能播放通知声音吗？”

配置

环境变量（可选）：

• CUSTOM_SOUND_PATH：自定义音频文件的路径
• VOLUME_LEVEL：播放音量（0.0-1.0，默认值：0.8）
• ENABLE_FALLBACK：启用回退到默认声音（默认值：true）
• AUDIO_DEVICE：特定的音频输出设备名称（例如“Mac Studio扬声器”）

可用工具

play_notification_sound

播放通知声音以提醒用户。

参数：

• custom_sound_path （可选）：自定义音频文件的路径
• message （可选）：通知的上下文消息

get_audio_status

返回当前音频系统状态和配置。

test_audio_playback

测试音频播放功能。

参数：

• use_custom （可选）：如果已配置，则使用自定义声音进行测试

list_audio_devices

列出系统上所有可用的音频输出设备。

退货：

• 可用音频设备及其属性列表
• 当前配置的设备（如有）
• 默认设备信息

发展

先决条件

• Python 3.10+
• uv（推荐）或pip

测试

pytest tests/

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

致谢

• 模型上下文协议 通过Anthropic
• Python音频库维护人员