音频 MCP 服务器

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

特性

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

先决条件

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

安装

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 桌面配置

要将此服务器与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与各种音频功能集成，使其能够更自然地与您的计算机交互。