金大哥 - Audio Interface MCP 详情

article

README

🚀 音频 MCP 服务器

这是一个专为 AI 助手（如 Claude）打造的 MCP（模型上下文协议）服务器，它赋予了 Claude 与计算机音频系统交互的能力，支持从麦克风录音，也能通过扬声器播放音频，极大地丰富了 Claude 的使用场景。

🚀 快速开始

在使用该服务器前，请确保满足以下先决条件：

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

✨ 主要特性

列出音频设备：可查看系统中所有可用的麦克风和扬声器。
录音：能从任意麦克风捕获音频，且时长和质量均可自定义。
回放录音：可播放最近一次录制的内容。
音频文件播放：能通过扬声器播放音频文件。
文本转语音：此功能即将推出。

📦 安装指南

手动安装

克隆此仓库或下载文件到本地：

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

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

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

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

使用方法

服务器设置完成后，重新启动 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 与各种音频功能集成，让它与计算机的交互更加自然流畅。

Audio Interface