音频 MCP 服务器

一个 MCP (模型上下文协议) 服务器，为像 Claude 这样的 AI 助手提供音频输入/输出功能。该服务器使 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. 或者使用包含的 setup 脚本来自动安装：

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"
      }
    }
  }
}

将路径替换为您系统上的实际路径。 setup 脚本将为您生成此配置。

用法

设置服务器后，重新启动 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 进行音频处理

---

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