音频MCP服务器
MCP（模型上下文协议）服务器，为Claude等AI助手提供音频输入/输出功能。此服务器使Claude能够与您计算机的音频系统进行交互，包括从麦克风录制和通过扬声器播放音频。
特性
- 列出音频设备：查看系统上所有可用的麦克风和扬声器
- 录制音频：以可定制的持续时间和质量从任何麦克风捕获音频
- 播放录音：播放您最近的录音
- 音频文件播放：通过扬声器播放音频文件
- 文本转语音：（未来实施的占位符）
需求
- Python 3.8或更高版本
- 系统上的音频输入/输出设备
安装
通过Smithery安装
通过以下方式自动安装Claude Desktop的音频接口服务器 史密瑟里:
npx -y @smithery/cli install @GongRzhe/Audio-MCP-Server --client claude手动安装
- 克隆此存储库或将文件下载到您的计算机：
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 - 视窗:
%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。您应该在输入框中看到一个锤子图标，表示工具可用。
试着问克劳德：
- “我的系统上有哪些麦克风和扬声器？”
- “从我的麦克风录制5秒的音频。”
- “播放录音。”
- “从我的计算机播放音频文件。”
可用工具
列表_音频_设备
列出系统上所有可用的音频输入和输出设备。
录音_音频
从麦克风录制音频。
参数：
duration：录制持续时间（秒）（默认值：5）sample_rate：采样率（Hz）（默认值：44100）channels：音频通道数（默认值：1）device_index：要使用的特定输入设备索引（默认值：系统默认值）
播放_最新记录
播放最近录制的音频。
播放_音频
文本转语音功能的占位符。
参数：
text：要转换为语音的文本voice：要使用的语音（默认值：“默认”）
播放音频文件
通过扬声器播放音频文件。
参数：
file_path：音频文件的路径device_index：要使用的特定输出设备索引（默认值：系统默认值）
故障排除
未找到设备
如果未找到音频设备，请检查：
- 您的麦克风和扬声器已正确连接
- 您的操作系统能够识别这些设备
- 您拥有访问音频设备的必要权限
播放问题
如果音频播放不起作用：
- 检查音量设置
- 确保选择了正确的输出设备
- 尝试重新启动Claude Desktop应用程序
服务器连接
如果Claude无法连接到服务器：
- 验证配置路径是否正确
- 确保Python和所有依赖项都已安装
- 检查克劳德的日志以获取错误消息
许可证
麻省理工学院
致谢
______________________________________________________________________
*注意：此服务器提供可以访问麦克风和扬声器的工具。在执行工具操作之前，始终对其进行审查和批准。*
