Serveur MCP audio

Un serveur MCP (Model Context Protocol) qui fournit des capacités d'entrée/sortie audio pour les assistants IA comme Claude. Ce serveur permet à Claude d'interagir avec le système audio de votre ordinateur, y compris l'enregistrement à partir de microphones et la lecture audio à travers des haut-parleurs.

Caractéristiques

• Liste des périphériques audio: Affiche tous les microphones et haut-parleurs disponibles sur votre système
• Enregistrer de l'audio: Capturez de l'audio à partir de n'importe quel microphone avec une durée et une qualité personnalisables
• Lecture des enregistrements: Lecture de l'enregistrement le plus récent
• Lecture de fichiers audio: Lecture de fichiers audio par l'intermédiaire de vos haut-parleurs
• Synthèse vocale: (Placeholder pour une implémentation future)

Configuration requise

• Python 3.8 ou supérieur
• Dispositifs d'entrée/sortie audio sur votre système

Installation

Installation via Smithery

Pour installer le serveur d'interface audio pour Claude Desktop automatiquement via Smithery:

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

Installation manuelle

1. Clonez ce dépôt ou téléchargez les fichiers sur votre ordinateur :

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

2. Créez un environnement virtuel et installez les dépendances :

# 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. Vous pouvez également utiliser le script d'installation inclus pour automatiser l'installation :

python setup_mcp.py

Configuration de l'application

Configuration de Claude Desktop

Pour utiliser ce serveur avec Claude Desktop, ajoutez ce qui suit à votre fichier de configuration de Claude Desktop :

• macOS: ~/Bibliothèque/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claudeclaude_desktop_config.json

{ "mcpServers" : { "audio-interface" : {"command" : "/path/to/your/.venv/bin/python", "args" : ["/path/to/your/audio_server.py" ], "env" : { "PYTHONPATH" : "/chemin/vers/votre/audio-mcp-server" } } }

Remplacez les chemins d'accès par les chemins d'accès réels de votre système. Le script d'installation générera cette configuration pour vous.

Utilisation

Après avoir configuré le serveur, redémarrez Claude Desktop. Vous devriez voir une icône de marteau dans la boîte de saisie, indiquant que des outils sont disponibles.

Essayez de demander à Claude :

• "Quels sont les microphones et les haut-parleurs disponibles sur mon système ?"
• "Enregistrez 5 secondes d'audio à partir de mon microphone."
• "Lire l'enregistrement audio"
• "Lire un fichier audio à partir de mon ordinateur"

Outils disponibles

list_audio_devices

Liste tous les périphériques d'entrée et de sortie audio disponibles sur votre système.

record_audio

Enregistre l'audio à partir de votre microphone.

Paramètres :

• duration: Durée de l'enregistrement en secondes (par défaut : 5)
• sample_rate: Taux d'échantillonnage en Hz (par défaut : 44100)
• channels: Nombre de canaux audio (par défaut : 1)
• device_index: Index du périphérique d'entrée spécifique à utiliser (par défaut : système par défaut)

play_latest_recording

Lit le dernier enregistrement audio.

play_audio

Placement pour la fonctionnalité de synthèse vocale.

Paramètres :

• texte: Le texte à convertir en parole
• voice: La voix à utiliser (par défaut : "default")

play_audio_file

Joue un fichier audio sur vos haut-parleurs.

Paramètres :

• chemin_fichier: Chemin d'accès au fichier audio
• device_index: Index du périphérique de sortie spécifique à utiliser (par défaut : par défaut du système)

Résolution des problèmes

Aucun périphérique trouvé

Si aucun périphérique audio n'est trouvé, vérifiez les points suivants

• Votre microphone et vos haut-parleurs sont correctement connectés
• Votre système d'exploitation reconnaît les périphériques
• Vous disposez des autorisations nécessaires pour accéder aux périphériques audio

Problèmes de lecture

Si la lecture audio ne fonctionne pas :

• Vérifiez vos paramètres de volume
• Assurez-vous que le bon périphérique de sortie est sélectionné
• Essayez de redémarrer l'application Claude Desktop

Connectivité au serveur

Si Claude ne peut pas se connecter au serveur :

• Vérifiez que les chemins de configuration sont corrects
• Assurez-vous que Python et toutes les dépendances sont installées
• Vérifiez les messages d'erreur dans les journaux de Claude

Licence

MIT

Remerciements

• Construit en utilisant le Protocole Modèle Contexte
• Utilise sounddevice et soundfile pour le traitement audio

Note : Ce serveur fournit des outils qui peuvent accéder à votre microphone et à vos haut-parleurs. Vérifiez et approuvez toujours les actions des outils avant qu'ils ne s'exécutent.