MCP Sound Tool
2025.03.24
0
Python音频反馈开发工具开发效率
py-sound-mcp 是一个基于 Model Context Protocol (MCP) 实现的音频反馈工具，旨在为 Cursor AI 和其他 MCP 兼容环境提供声音效果。该工具通过播放不同的声音效果（如完成、错误、通知等）来增强交互式编码体验。
View on GitHub
Overview
基本能力
产品定位
py-sound-mcp 是一个音频反馈工具，用于在开发环境中提供声音提示，增强用户体验。
核心功能
- 播放多种事件的声音效果（完成、错误、通知等）
- 使用 Model Context Protocol (MCP) 实现标准化集成
- 支持跨平台（Windows、macOS、Linux）
- 可配置的声音效果
适用场景
- 在代码生成完成后播放完成音效
- 在发生错误时播放错误音效
- 在需要用户注意时播放通知音效
工具列表
play_sound(sound_type="completion", custom_sound_path=None): 播放指定类型的声音效果list_available_sounds(): 列出所有可用的声音文件install_to_user_dir(): 将声音文件安装到用户配置目录
常见问题解答
- 如果遇到 Python 3.12+ 的
BrokenResourceError或TaskGroup异常，建议使用 Python 3.8-3.11 版本。 - 推荐使用 pipx 安装以避免包冲突。
使用教程
使用依赖
- Python 3.8-3.11
- pipx（推荐）
安装教程
推荐使用 pipx 安装
# 安装 pipx
python -m pip install --user pipx
python -m pipx ensurepath
# 安装 mcp-sound-tool
pipx install mcp-sound-tool
使用 pip 安装
pip install mcp-sound-tool
从源码安装
git clone https://github.com/yourusername/mcp-sound-tool
cd mcp-sound-tool
pipx install .
# 或
pip install -e .
调试方式
- 运行 MCP 服务器
mcp-sound-tool
- 在 Cursor 中配置 MCP 服务器（参考 README 中的配置示例）
- 测试声音效果是否正常播放