🚀 音频 MCP 服务器
音频 MCP 服务器是一个提供音频输入/输出功能的 MCP（模型上下文协议）服务器，专为 AI 助手如Claude 打造。借助该服务器，Claude 能够与您的计算机音频系统进行交互，实现从麦克风录音以及通过扬声器播放音频等操作。
🚀 快速开始
安装服务器后，重启Claude Desktop。您应该在输入框中看到锤子图标，表示工具可用。 尝试询问Claude：
- “我的系统上有哪些麦克风和扬声器？”
- “用我的麦克风录音5秒钟。”
- “回放音频记录。”
- “通过我的计算机播放音频文件。”
✨ 主要特性
- 列出音频设备：查看系统上的所有麦克风和扬声器
- 录音：从任何麦克风捕获音频，具有可自定义的时长和质量
- 回放录音：播放最近一次的录音
- 音频文件播放：通过扬声器播放音频文件
- 文本到语音：（未来实现占位符）
📦 安装指南
手动安装
- 克隆此仓库或下载文件到您的计算机：
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"
}
}
}
}
将路径替换为您系统上的实际路径。设置脚本会自动生成此配置。
可用工具
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：特定输出设备索引（默认：系统默认）
故障排除
没有设备发现
如果未找到任何音频设备，请检查：
- 您的麦克风和扬声器已正确连接
- 操作系统识别设备
- 您有访问音频设备的权限
播放问题
如果无法播放录音，请检查：
- 扬声器是否正确连接并启用
- 音量设置是否正确
- 录音文件格式是否兼容
注意事项
此项目需要麦克风和扬声器硬件支持，并且可能需要管理员权限来访问设备。在某些系统上，您可能需要调整音频配置或使用不同的音频接口。
📄 许可证
请查看项目的LICENSE文件以获取详细许可信息。