Audio MCP Server

Fornece capacidades de entrada e saída de áudio para assistentes de IA.

Documentação

Audio MCP Server

Um servidor MCP (Model Context Protocol) que fornece capacidades de entrada/saída de áudio para assistentes de IA como o Claude. Este servidor permite que o Claude interaja com o sistema de áudio do seu computador, incluindo gravação de microfones e reprodução de áudio pelos alto-falantes.

Recursos

Listar Dispositivos de Áudio: Visualize todos os microfones e alto-falantes disponíveis no seu sistema
Gravar Áudio: Capture áudio de qualquer microfone com duração e qualidade personalizáveis
Reproduzir Gravações: Reproduza sua gravação mais recente
Reprodução de Arquivos de Áudio: Reproduza arquivos de áudio pelos seus alto-falantes
Texto para Fala: (Placeholder para implementação futura)

Requisitos

Python 3.8 ou superior
Dispositivos de entrada/saída de áudio no seu sistema

Instalação

Instalando via Smithery

Para instalar o Audio Interface Server para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

Clone este repositório ou baixe os arquivos para o seu computador:

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

Crie um ambiente virtual e instale as dependências:

# 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

Ou use o script de configuração incluído para automatizar a instalação:

python setup_mcp.py

Configuração

Configuração do Claude Desktop

Para usar este servidor com o Claude Desktop, adicione o seguinte ao seu arquivo de configuração do 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"
      }
    }
  }
}

Substitua os caminhos pelos caminhos reais do seu sistema. O script de configuração gerará esta configuração para você.

Uso

Após configurar o servidor, reinicie o Claude Desktop. Você deve ver um ícone de martelo na caixa de entrada, indicando que as ferramentas estão disponíveis.

Tente perguntar ao Claude:

"Quais microfones e alto-falantes estão disponíveis no meu sistema?"
"Grave 5 segundos de áudio do meu microfone."
"Reproduza a gravação de áudio."
"Reproduza um arquivo de áudio do meu computador."

Ferramentas Disponíveis

list_audio_devices

Lista todos os dispositivos de entrada e saída de áudio disponíveis no seu sistema.

record_audio

Grava áudio do seu microfone.

Parâmetros:

duration: Duração da gravação em segundos (padrão: 5)
sample_rate: Taxa de amostragem em Hz (padrão: 44100)
channels: Número de canais de áudio (padrão: 1)
device_index: Índice específico do dispositivo de entrada a ser usado (padrão: padrão do sistema)

play_latest_recording

Reproduz o áudio gravado mais recentemente.

play_audio

Placeholder para funcionalidade de texto para fala.

Parâmetros:

text: O texto a ser convertido em fala
voice: A voz a ser usada (padrão: "default")

play_audio_file

Reproduz um arquivo de áudio pelos seus alto-falantes.

Parâmetros:

file_path: Caminho para o arquivo de áudio
device_index: Índice específico do dispositivo de saída a ser usado (padrão: padrão do sistema)

Solução de Problemas

Nenhum dispositivo encontrado

Se nenhum dispositivo de áudio for encontrado, verifique:

Seu microfone e alto-falantes estão conectados corretamente
Seu sistema operacional reconhece os dispositivos
Você tem as permissões necessárias para acessar os dispositivos de áudio

Problemas de reprodução

Se a reprodução de áudio não estiver funcionando:

Verifique suas configurações de volume
Certifique-se de que o dispositivo de saída correto está selecionado
Tente reiniciar o aplicativo Claude Desktop

Conectividade do servidor

Se o Claude não conseguir se conectar ao servidor:

Verifique se os caminhos da sua configuração estão corretos
Certifique-se de que o Python e todas as dependências estão instalados
Verifique os logs do Claude para mensagens de erro

Licença

MIT

Agradecimentos

Construído usando o Model Context Protocol
Usa sounddevice e soundfile para processamento de áudio

Nota: Este servidor fornece ferramentas que podem acessar seu microfone e alto-falantes. Sempre revise e aprove as ações das ferramentas antes de executá-las.