Audio MCP Server

🚀 音频 MCP 服务器

音频 MCP 服务器是一个提供音频输入/输出功能的 MCP（模型上下文协议）服务器，专为 AI 助手如Claude 打造。借助该服务器，Claude 能够与您的计算机音频系统进行交互，实现从麦克风录音以及通过扬声器播放音频等操作。

🚀 快速开始

安装服务器后，重启Claude Desktop。您应该在输入框中看到锤子图标，表示工具可用。 尝试询问Claude：

• “我的系统上有哪些麦克风和扬声器？”
• “用我的麦克风录音5秒钟。”
• “回放音频记录。”
• “通过我的计算机播放音频文件。”

✨ 主要特性

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

📦 安装指南

手动安装

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

自动化安装

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

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

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

可用工具

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：特定输出设备索引（默认：系统默认）

故障排除

没有设备发现

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

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

播放问题

如果无法播放录音，请检查：

• 扬声器是否正确连接并启用
• 音量设置是否正确
• 录音文件格式是否兼容

注意事项

此项目需要麦克风和扬声器硬件支持，并且可能需要管理员权限来访问设备。在某些系统上，您可能需要调整音频配置或使用不同的音频接口。

📄 许可证

请查看项目的LICENSE文件以获取详细许可信息。