Audio MCP Server

by GongRzhe
Verified
MIT License
1
  • Linux
  • Apple

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides audio input/output capabilities on Linux systems through the Python-based MCP server implementation.

  • Provides audio input/output capabilities on macOS systems through configuration in the Claude Desktop application.

Servidor de audio MCP

Un servidor MCP (Protocolo de Contexto de Modelo) que proporciona funciones de entrada/salida de audio para asistentes de IA como Claude. Este servidor permite a Claude interactuar con el sistema de audio de su computadora, incluyendo la grabación de micrófonos y la reproducción de audio por altavoces.

Características

  • Lista de dispositivos de audio : vea todos los micrófonos y altavoces disponibles en su sistema
  • Grabar audio : captura audio desde cualquier micrófono con duración y calidad personalizables
  • Reproducir grabaciones : Reproduzca su grabación más reciente
  • Reproducción de archivos de audio : reproduce archivos de audio a través de tus 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 su sistema

Instalación

  1. Clona este repositorio o descarga los archivos a tu computadora:
git clone https://github.com/GongRzhe/Audio-MCP-Server.git cd Audio-MCP-Server
  1. Cree un entorno virtual e instale 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
  1. O utilice el script de configuración incluido para automatizar la instalación:
python setup_mcp.py

Configuración

Configuración del escritorio de Claude

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

  • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
  • Ventanas : %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" } } } }

Reemplace las rutas con las rutas reales de su sistema. El script de configuración generará esta configuración automáticamente.

Uso

Después de configurar el servidor, reinicie Claude Desktop. Debería ver un icono de martillo en el cuadro de entrada, lo que indica que hay herramientas disponibles.

Prueba a preguntarle a Claude:

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

Herramientas disponibles

lista_de_dispositivos_de_audio

Enumera todos los dispositivos de entrada y salida de audio disponibles en su sistema.

grabar 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 del dispositivo de entrada específico a utilizar (predeterminado: predeterminado del sistema)

reproducir_la_última_grabación

Reproduce el audio grabado más recientemente.

reproducir audio

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

Parámetros:

  • text : El texto a convertir a voz
  • voice : La voz a utilizar (predeterminado: "predeterminado")

reproducir archivo de audio

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

Parámetros:

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

Solución de problemas

No se encontraron dispositivos

Si no se encuentran dispositivos de audio, verifique:

  • Su micrófono y 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úrese de que esté seleccionado el dispositivo de salida correcto
  • Intente reiniciar la aplicación Claude Desktop

Conectividad del servidor

Si Claude no puede conectarse al servidor:

  • Verifique que sus rutas de configuración sean correctas
  • Asegúrese de que Python y todas las dependencias estén instaladas
  • Consulte los registros de Claude para ver si hay mensajes de error

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Expresiones de gratitud


Nota: Este servidor proporciona herramientas que permiten acceder a su micrófono y altavoces. Siempre revise y apruebe las acciones de las herramientas antes de ejecutarlas.

-
security - not tested
A
license - permissive license
-
quality - not tested

Permite que Claude y otros asistentes de IA interactúen con el sistema de audio de su computadora, lo que permite grabar desde micrófonos y reproducir audio a través de altavoces.

  1. Features
    1. Requirements
      1. Installation
        1. Configuration
          1. Claude Desktop Configuration
        2. Usage
          1. Available Tools
            1. list_audio_devices
            2. record_audio
            3. play_latest_recording
            4. play_audio
            5. play_audio_file
          2. Troubleshooting
            1. No devices found
            2. Playback issues
            3. Server connectivity
          3. License
            1. Acknowledgments
              ID: 1zw7hxwxx7