音频 MCP 服务器

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

特征

• 列出音频设备：查看系统上所有可用的麦克风和扬声器

• 录制音频：从任何麦克风捕获可自定义持续时间和质量的音频

• 播放录音：播放最近的录音

• 音频文件播放：通过扬声器播放音频文件

• 文本转语音：（未来实现的占位符）

Related MCP server: Sound Effects MCP

要求

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

尝试询问克劳德：

• “我的系统上有哪些麦克风和扬声器？”

• “用我的麦克风录制 5 秒的音频。”

• “播放录音。”

• “从我的电脑播放音频文件。”

可用工具

列出音频设备

列出系统上所有可用的音频输入和输出设备。

录制音频

录制麦克风的音频。

参数：

• duration ：录制持续时间（以秒为单位）（默认值：5）

• sample_rate ：采样率（赫兹）（默认值：44100）

• channels ：音频通道数（默认值：1）

• device_index ：要使用的特定输入设备索引（默认值：系统默认值）

播放最新录音

播放最近录制的音频。

播放音频

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

参数：

• text ：要转换为语音的文本

• voice ：要使用的语音（默认值：“default”）

播放音频文件

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

参数：

• file_path ：音频文件的路径

• device_index ：要使用的特定输出设备索引（默认值：系统默认值）

故障排除

未找到设备

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

• 您的麦克风和扬声器已正确连接

• 您的操作系统识别该设备

• 您拥有访问音频设备的必要权限

播放问题

如果音频播放不正常：

• 检查音量设置

• 确保选择了正确的输出设备

• 尝试重新启动 Claude Desktop 应用程序

服务器连接

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

• 验证配置路径是否正确

• 确保已安装 Python 和所有依赖项

• 检查 Claude 的日志中的错误消息

执照

麻省理工学院

致谢

• 使用模型上下文协议构建

• 使用声音设备和声音文件进行音频处理

注意：此服务器提供可访问您麦克风和扬声器的工具。请务必在执行工具操作前进行审核并获得批准。