🚀 音频 MCP 服务器
这是一个专为 AI 助手（如 Claude）打造的 MCP（模型上下文协议）服务器，它赋予了 Claude 与计算机音频系统交互的能力，支持从麦克风录音，也能通过扬声器播放音频，极大地丰富了 Claude 的使用场景。
🚀 快速开始
在使用该服务器前，请确保满足以下先决条件：
- Python 3.8 或更高版本
- 系统上的音频输入/输出设备
✨ 主要特性
- 列出音频设备：可查看系统中所有可用的麦克风和扬声器。
- 录音：能从任意麦克风捕获音频，且时长和质量均可自定义。
- 回放录音：可播放最近一次录制的内容。
- 音频文件播放：能通过扬声器播放音频文件。
- 文本转语音：此功能即将推出。
📦 安装指南
手动安装
- 克隆此仓库或下载文件到本地：
git clone https://github.com/GongRzhe/Audio-MCP-Server.git
cd Audio-MCP-Server
- 创建虚拟环境并安装依赖项：
# Windows
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
# macOS/Linux
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
自动化安装
也可使用包含的设置脚本来自动化安装：
python setup_mcp.py
📚 详细文档
配置
Claude 桌面配置
若要将此服务器与 Claude Desktop 配合使用，需在 Claude Desktop 配置文件中添加以下内容：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - Windows：
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"audio-interface": {
"command": "/path/to/your/.venv/bin/python",
"args": [
"/path/to/your/audio_server.py"
],
"env": {
"PYTHONPATH": "/path/to/your/audio-mcp-server"
}
}
}
}
请用实际系统上的路径替换上述路径，设置脚本会自动为您生成此配置。
使用方法
服务器设置完成后，重新启动 Claude Desktop。若输入框中出现锤子图标，则表示工具已可用。您可以尝试向 Claude 询问以下问题：
- “我的系统上有哪些可用的麦克风和扬声器？”
- “从我的麦克风录制 5 秒钟的音频。”
- “回放录音。”
- “通过我的计算机播放音频文件。”
可用工具
list_audio_devices
列出系统上所有可用的音频输入和输出设备。
record_audio
从麦克风记录音频。 参数：
duration：录制持续时间，单位为秒（默认：5）sample_rate：采样率，单位为赫兹（默认：44100）channels：音频声道数量（默认：1）device_index：特定输入设备索引（默认：系统默认）
play_latest_recording
播放最近一次录制的音频。
play_audio
文本转语音功能占位符。 参数：
text：要转换为语音的文本voice：要使用的语音（默认：“default”）
play_audio_file
通过扬声器播放音频文件。 参数：
file_path：音频文件的路径device_index：特定输出设备索引（默认：系统默认）
故障排除
没有设备找到
若找不到任何音频设备，请检查以下方面：
- 麦克风和扬声器是否正确连接
- 操作系统是否识别这些设备
- 是否具有访问音频设备的必要权限
播放问题
若遇到播放问题，请检查以下内容：
- 确保使用的设备索引在系统上存在
- 验证音频文件路径是否正确
- 确保音频文件格式受支持
📄 许可证
本项目遵循MIT License。
借助这个服务器，您能轻松地将 Claude 与各种音频功能集成，让它与计算机的交互更加自然流畅。