音频MCP服务器

这是一个提供音频输入/输出功能的MCP（模型上下文协议）服务器，适用于像Claude这样的AI助手。此服务器使Claude能够与计算机的音频系统进行交互，包括从麦克风录音并通过扬声器播放音频。

功能

• 列出音频设备：查看系统上所有可用的麦克风和扬声器
• 录音：从任何麦克风捕获音频，可自定义时长和质量
• 播放录音：播放最近录制的音频
• 播放音频文件：通过扬声器播放音频文件
• 文本转语音：（未来实现的占位符）

要求

• Python 3.8或更高版本
• 系统上的音频输入/输出设备

安装

通过Smithery安装

要通过Smithery自动安装Claude Desktop的音频接口服务器：

npx -y @smithery/cli install @GongRzhe/Audio-MCP-Server --client claude

手动安装

1. 将此仓库克隆到您的计算机或下载文件：

git clone https://github.com/GongRzhe/Audio-MCP-Server.git
cd Audio-MCP-Server

2. 创建虚拟环境并安装依赖项：

# 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

3. 或使用包含的设置脚本来自动化安装：

python setup_mcp.py

配置

Claude Desktop配置

要使用此服务器与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：采样率（Hz，默认值：44100）
• channels：音频通道数（默认值：1）
• device_index：特定输入设备索引（默认值：系统默认）

play_latest_recording

播放最近录制的音频。

play_audio

文本转语音功能的占位符。

参数：

• text：要转换为语音的文本
• voice：使用的语音（默认值："default"）

play_audio_file

通过扬声器播放音频文件。

参数：

• file_path：音频文件的路径
• device_index：特定输出设备索引（默认值：系统默认）

故障排除

没有找到设备

如果找不到音频设备，请检查：

• 您的麦克风和扬声器是否正确连接
• 操作系统是否识别这些设备
• 您是否有访问音频设备所需的权限

播放问题

如果音频播放不正常：

• 检查音量设置
• 确保选择了正确的输出设备
• 尝试重启Claude Desktop应用程序

服务器连接问题

如果Claude无法连接到服务器：

• 验证配置路径是否正确
• 确保已安装Python和所有依赖项
• 查看Claude的日志以获取错误消息

许可证

MIT

致谢

• 使用模型上下文协议构建
• 使用sounddevice和soundfile进行音频处理

---

注意：此服务器提供了可以访问您的麦克风和扬声器的工具。在执行之前，请始终审查并批准工具操作。