Audio MCP 服务器

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

特性

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

要求

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

安装

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

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

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

# 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

1. 或者使用包含的设置脚本来自动化安装过程：

python setup_mcp.py

配置

Claude 桌面配置

要将此服务器与Claude桌面一起使用，请在您的Claude桌面配置文件中添加以下内容：

• 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桌面。您应该会在输入框中看到一个锤子图标，表示工具可用。

试着问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: 使用的具体输出设备索引（默认值：系统默认）

故障排除

未找到设备

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

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

播放问题

如果音频播放不工作：

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

服务器连接

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

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

许可证

MIT

致谢

• 使用 Model Context Protocol 构建
• 使用 sounddevice 和 soundfile 进行音频处理

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