Servidor MCP de audio

Un servidor MCP (Model Context Protocol) que proporciona capacidades de entrada/salida de audio para asistentes de IA como Claude. Este servidor permite a Claude interactuar con el sistema de audio de tu ordenador, incluyendo la grabación desde micrófonos y la reproducción de audio a través de altavoces.

Características

• Lista de dispositivos de audio: Visualiza todos los micrófonos y altavoces disponibles en tu sistema
• Grabar audio: Captura audio desde cualquier micrófono con duración y calidad personalizables
• Reproducir grabaciones: Reproduce la grabación más reciente
• Reproducción de archivos de audio: Reproduce archivos de audio a través de los altavoces
• Texto a voz: (Marcador de posición para una futura implementación)

Requisitos

• Python 3.8 o superior
• Dispositivos de entrada/salida de audio en tu sistema

Instalación

Instalación a través de Smithery

Para instalar Audio Interface Server para Claude Desktop automáticamente vía Smithery:

npx -y @smithery/cli install @GongRzhe/Audio-MCP-Server --client claude

Instalación manual

1. Clone este repositorio o descargue los archivos a su ordenador:

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

2. Crea un entorno virtual e instala las dependencias:

# 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. O utilice el script de instalación incluido para automatizar la instalación:

python setup_mcp.py

Configuración

Configuración de Claude Desktop

Para utilizar este servidor con Claude Desktop, añada lo siguiente a su archivo de configuración de Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{"mcpServers": { "audio-interface": {"command": "/ruta/a/tu/.venv/bin/python", "args": [ "/ruta/su/servidor/audio.py" ], "env": {"PYTHONPATH": "/ruta/su/servidor-audio-mcp" } } }

Sustituya las rutas por las rutas reales de su sistema. El script de instalación generará esta configuración para usted.

Uso

Después de configurar el servidor, reinicie Claude Desktop. Debería ver un icono de martillo en el cuadro de entrada, indicando que las herramientas están disponibles.

Pruebe a preguntar a Claude:

• "¿Qué micrófonos y altavoces están disponibles en mi sistema?"
• "Grabar 5 segundos de audio desde mi micrófono"
• "Reproducir la grabación de audio"
• "Reproducir un archivo de audio desde mi ordenador"

Herramientas disponibles

list_audio_devices

Lista todos los dispositivos de entrada y salida de audio disponibles en tu sistema.

grabar_audio

Graba audio desde su micrófono.

Parámetros:

• duration: Duración de la grabación en segundos (por defecto: 5)
• sample_rate: Frecuencia de muestreo en Hz (por defecto: 44100)
• channels: Número de canales de audio (por defecto: 1)
• device_index: Índice específico del dispositivo de entrada a utilizar (por defecto: por defecto del sistema)

reproducir_última_grabación

Reproduce el audio grabado más recientemente.

reproducir_audio

Marcador de posición para la función de texto a voz.

Parámetros:

• texto: El texto a convertir en voz
• voice: La voz a utilizar (por defecto: "default")

reproducir_archivo_audio

Reproduce un archivo de audio a través de los altavoces.

Parámetros:

• ruta_archivo: Ruta al archivo de audio
• device_index: Índice del dispositivo de salida específico a utilizar (por defecto: por defecto del sistema)

Solución de problemas

No se encuentran dispositivos

Si no se encuentra ningún dispositivo de audio, compruebe

• El micrófono y los altavoces están conectados correctamente
• Su sistema operativo reconoce los dispositivos
• Tienes los permisos necesarios para acceder a los dispositivos de audio

Problemas de reproducción

Si la reproducción de audio no funciona

• Comprueba la configuración del volumen
• Asegúrate de haber seleccionado el dispositivo de salida correcto
• Intente reiniciar la aplicación Claude Desktop

Conectividad del servidor

Si Claude no puede conectarse al servidor

• Compruebe que las rutas de configuración son correctas
• Asegúrese de que Python y todas las dependencias están instaladas
• Compruebe si hay mensajes de error en los registros de Claude

Licencia

MIT

Agradecimientos

• Construido usando el Protocolo de Contexto de Modelo
• Utiliza sounddevice y soundfile para el procesamiento de audio

Nota: Este servidor proporciona herramientas que pueden acceder a su micrófono y altavoces. Revise y apruebe siempre las acciones de las herramientas antes de que se ejecuten.