Audio MCP Server

Proporciona capacidades de entrada y salida de audio para asistentes de IA.

Documentación

Audio MCP Server

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

Características

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

Requisitos

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

Instalación

Instalación mediante Smithery

Para instalar Audio Interface Server para Claude Desktop automáticamente a través de Smithery:

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

Instalación manual

Clona este repositorio o descarga los archivos a tu computadora:

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

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

O usa el script de configuración incluido para automatizar la instalación:

python setup_mcp.py

Configuración

Configuración de Claude Desktop

Para usar este servidor con Claude Desktop, agrega lo siguiente a tu 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": "/path/to/your/.venv/bin/python",
      "args": [
        "/path/to/your/audio_server.py"
      ],
      "env": {
        "PYTHONPATH": "/path/to/your/audio-mcp-server"
      }
    }
  }
}

Reemplaza las rutas con las rutas reales de tu sistema. El script de configuración generará esta configuración por ti.

Uso

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

Prueba preguntarle a Claude:

"¿Qué micrófonos y altavoces están disponibles en mi sistema?"
"Graba 5 segundos de audio desde mi micrófono."
"Reproduce la grabación de audio."
"Reproduce un archivo de audio desde mi computadora."

Herramientas disponibles

list_audio_devices

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

record_audio

Graba audio desde tu micrófono.

Parámetros:

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

play_latest_recording

Reproduce el audio grabado más recientemente.

play_audio

Marcador de posición para funcionalidad de texto a voz.

Parámetros:

text: El texto a convertir en voz
voice: La voz a usar (predeterminado: "default")

play_audio_file

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

Parámetros:

file_path: Ruta al archivo de audio
device_index: Índice específico del dispositivo de salida a usar (predeterminado: sistema predeterminado)

Solución de problemas

No se encontraron dispositivos

Si no se encuentran dispositivos de audio, verifica:

Que tu micrófono y altavoces estén conectados correctamente
Que tu sistema operativo reconozca los dispositivos
Que tengas los permisos necesarios para acceder a los dispositivos de audio

Problemas de reproducción

Si la reproducción de audio no funciona:

Verifica la configuración de volumen
Asegúrate de que el dispositivo de salida correcto esté seleccionado
Intenta reiniciar la aplicación Claude Desktop

Conectividad del servidor

Si Claude no puede conectarse al servidor:

Verifica que las rutas de configuración sean correctas
Asegúrate de que Python y todas las dependencias estén instaladas
Revisa los registros de Claude para ver mensajes de error

Licencia

MIT

Agradecimientos

Construido usando el Model Context Protocol
Usa sounddevice y soundfile para el procesamiento de audio

Nota: Este servidor proporciona herramientas que pueden acceder a tu micrófono y altavoces. Siempre revisa y aprueba las acciones de las herramientas antes de que se ejecuten.