Servidor Audio MCP

Audio MCP Server

Un servidor MCP (Model Context Protocol) que ofereix capacitats d’entrada/sortida d’àudio per a assistents IA com Claude. Aquest servidor permet a Claude interactuar amb el sistema d’àudio del teu ordinador, incloent la gravació des de micròfons i la reproducció d’àudio a través d’altaveus.

Features

List Audio Devices: Veure tots els micròfons i altaveus disponibles al teu sistema
Record Audio: Captura àudio des de qualsevol micròfon amb durada i qualitat personalitzables
Playback Recordings: Reprodueix la gravació més recent
Audio File Playback: Reprodueix fitxers d’àudio a través dels teus altaveus
Text-to-Speech: (Marcador de posició per a futura implementació)

Requirements

Python 3.8 o superior
Dispositius d’entrada/sortida d’àudio al teu sistema

Installation

Installing via Smithery

Per instal·lar el servidor Audio Interface per a Claude Desktop automàticament via Smithery:

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

Manual Installation

Clona aquest repositori o baixa els fitxers al teu ordinador:

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

Crea un entorn virtual i instal·la les dependències:

# 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 utilitza l’script d’instal·lació inclòs per automatitzar el procés:

python setup_mcp.py

Configuration

Claude Desktop Configuration

Per utilitzar aquest servidor amb Claude Desktop, afegeix el següent al fitxer de configuració 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"
      }
    }
  }
}

Substitueix els camins amb els camins reals del teu sistema. L’script d’instal·lació generarà aquesta configuració per a tu.

Usage

Després d’instal·lar el servidor, reinicia Claude Desktop. Hauràs d’observar una icona de martell a la caixa d’entrada, indicant que les eines estan disponibles.

Prova a preguntar a Claude:

"Quins micròfons i altaveus estan disponibles al meu sistema?"
"Grava 5 segons d’àudio des del meu micròfon."
"Reprodueix la gravació d’àudio."
"Reprodueix un fitxer d’àudio del meu ordinador."

Available Tools

list_audio_devices

Enumera tots els dispositius d’entrada i sortida d’àudio disponibles al teu sistema.

record_audio

Grava àudio des del teu micròfon.

Paràmetres:

duration: Durada de la gravació en segons (per defecte: 5)
sample_rate: Taxa de mostreig en Hz (per defecte: 44100)
channels: Nombre de canals d’àudio (per defecte: 1)
device_index: Índex del dispositiu d’entrada específic a utilitzar (per defecte: dispositiu per defecte del sistema)

play_latest_recording

Reprodueix la gravació d’àudio més recent.

play_audio

Marcador de posició per a funcionalitat de text-a-veu.

Paràmetres:

text: El text a convertir en veu
voice: La veu a utilitzar (per defecte: "default")

play_audio_file

Reprodueix un fitxer d’àudio a través dels teus altaveus.

Paràmetres:

file_path: Camí al fitxer d’àudio
device_index: Índex del dispositiu de sortida específic a utilitzar (per defecte: dispositiu per defecte del sistema)

Troubleshooting

No devices found

Si no es troben dispositius d’àudio, comprova:

Que els micròfons i altaveus estiguin correctament connectats
Que el sistema operatiu reconegui els dispositius
Que tinguis els permisos necessaris per accedir als dispositius d’àudio

Playback issues

Si la reproducció d’àudio no funciona:

Comprova la configuració del volum
Assegura't que el dispositiu de sortida correcte estigui seleccionat
Intenta reiniciar l’aplicació Claude Desktop

Server connectivity

Si Claude no pot connectar-se al servidor:

Verifica que els camins de configuració siguin correctes
Assegura't que Python i totes les dependències estiguin instal·lades
Revisa els logs de Claude per missatges d’error

License

MIT

Acknowledgments

Construït amb el Model Context Protocol
Utilitza sounddevice i soundfile per al processament d’àudio

Nota: Aquest servidor proporciona eines que poden accedir al teu micròfon i altaveus. Revisa i aprova sempre les accions de les eines abans que s'executin.