Audio-MCP-Server

Ein MCP-Server (Model Context Protocol), der Audio-Ein- und -Ausgabefunktionen für KI-Assistenten wie Claude bereitstellt. Dieser Server ermöglicht Claude die Interaktion mit dem Audiosystem Ihres Computers, einschließlich der Aufnahme von Mikrofonen und der Audiowiedergabe über Lautsprecher.

Merkmale

• Audiogeräte auflisten : Alle verfügbaren Mikrofone und Lautsprecher auf Ihrem System anzeigen

• Audio aufnehmen : Nehmen Sie Audio von jedem Mikrofon mit anpassbarer Dauer und Qualität auf

• Aufnahmen wiedergeben : Spielen Sie Ihre letzte Aufnahme ab

• Audiodateiwiedergabe : Spielen Sie Audiodateien über Ihre Lautsprecher ab

• Text-to-Speech : (Platzhalter für zukünftige Implementierung)

Related MCP server: Sound Effects MCP

Anforderungen

• Python 3.8 oder höher

• Audio-Ein-/Ausgabegeräte auf Ihrem System

Installation

Installation über Smithery

So installieren Sie den Audio Interface Server für Claude Desktop automatisch über Smithery :

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

Manuelle Installation

1. Klonen Sie dieses Repository oder laden Sie die Dateien auf Ihren Computer herunter:

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

2. Erstellen Sie eine virtuelle Umgebung und installieren Sie Abhängigkeiten:

# 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. Oder verwenden Sie das mitgelieferte Setup-Skript, um die Installation zu automatisieren:

python setup_mcp.py

Konfiguration

Claude Desktop-Konfiguration

Um diesen Server mit Claude Desktop zu verwenden, fügen Sie Ihrer Claude Desktop-Konfigurationsdatei Folgendes hinzu:

• 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"
      }
    }
  }
}

Ersetzen Sie die Pfade durch die tatsächlichen Pfade auf Ihrem System. Das Setup-Skript generiert diese Konfiguration für Sie.

Verwendung

Starten Sie Claude Desktop nach der Servereinrichtung neu. Im Eingabefeld sollte ein Hammersymbol angezeigt werden, das anzeigt, dass Tools verfügbar sind.

Versuchen Sie, Claude zu fragen:

• „Welche Mikrofone und Lautsprecher sind auf meinem System verfügbar?“

• „Nehmen Sie 5 Sekunden Audio von meinem Mikrofon auf.“

• „Spielen Sie die Audioaufnahme ab.“

• „Spielen Sie eine Audiodatei von meinem Computer ab.“

Verfügbare Tools

Liste_Audiogeräte

Listet alle verfügbaren Audio-Ein- und Ausgabegeräte auf Ihrem System auf.

Audio aufnehmen

Nimmt Audio von Ihrem Mikrofon auf.

Parameter:

• duration : Aufnahmedauer in Sekunden (Standard: 5)

• sample_rate : Abtastrate in Hz (Standard: 44100)

• channels : Anzahl der Audiokanäle (Standard: 1)

• device_index : Spezifischer zu verwendender Eingabegeräteindex (Standard: Systemstandard)

letzte_Aufnahme abspielen

Gibt die zuletzt aufgenommene Audiodatei wieder.

Audio abspielen

Platzhalter für die Text-to-Speech-Funktionalität.

Parameter:

• text : Der in Sprache umzuwandelnde Text

• voice : Die zu verwendende Stimme (Standard: „default“)

Audiodatei abspielen

Spielt eine Audiodatei über Ihre Lautsprecher ab.

Parameter:

• file_path : Pfad zur Audiodatei

• device_index : Spezifischer zu verwendender Ausgabegeräteindex (Standard: Systemstandard)

Fehlerbehebung

Keine Geräte gefunden

Wenn keine Audiogeräte gefunden werden, überprüfen Sie:

• Ihr Mikrofon und Ihre Lautsprecher sind richtig angeschlossen

• Ihr Betriebssystem erkennt die Geräte

• Sie verfügen über die erforderlichen Berechtigungen für den Zugriff auf Audiogeräte

Wiedergabeprobleme

Wenn die Audiowiedergabe nicht funktioniert:

• Überprüfen Sie Ihre Lautstärkeeinstellungen

• Stellen Sie sicher, dass das richtige Ausgabegerät ausgewählt ist

• Versuchen Sie, die Claude Desktop-Anwendung neu zu starten

Serverkonnektivität

Wenn Claude keine Verbindung zum Server herstellen kann:

• Überprüfen Sie, ob Ihre Konfigurationspfade korrekt sind

• Stellen Sie sicher, dass Python und alle Abhängigkeiten installiert sind

• Überprüfen Sie Claudes Protokolle auf Fehlermeldungen

Lizenz

MIT

Danksagung

• Erstellt mit dem Model Context Protocol

• Verwendet Soundgerät und Sounddatei zur Audioverarbeitung

Hinweis: Dieser Server stellt Tools bereit, die auf Ihr Mikrofon und Ihre Lautsprecher zugreifen können. Überprüfen und genehmigen Sie die Tool-Aktionen stets vor der Ausführung.