pmarmaroli/vocametrix-mcp

O que vocametrix-mcp faz?

Servidor oficial do Protocolo de Contexto de Modelo (MCP) para Vocametrix — integre análise clínica de voz (AVQI, DSI, jitter/shimmer, avaliação de pronúncia, similaridade de prosódia e mais de 40 outros) no Claude, Cursor, Zed, Windsurf e qualquer agente compatível com MCP.

Recursos

• Análise de Áudio: Extraia dezenas de métricas acústicas e clínicas de arquivos de áudio.
• Transcrição: Converta fala em texto com modelos de ponta.
• Avaliação de Pronúncia: Compare a pronúncia de um locutor com um texto-alvo.
• Comparação de Prosódia: Analise similaridade rítmica e entoacional entre duas amostras.

Plataformas Suportadas

• Claude Desktop
• Cursor
• Zed
• Windsurf
• Qualquer agente compatível com MCP

Instalação

npm

npm install -g @vocametrix/mcp-server

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "vocametrix": {
      "command": "npx",
      "args": ["-y", "@vocametrix/mcp-server"],
      "env": {
        "VOCAMETRIX_API_KEY": "sua-chave-aqui"
      }
    }
  }
}

Uso

Após configurar, o servidor expõe as seguintes ferramentas:

analyze-audio

Analisa um arquivo de áudio e retorna métricas clínicas.

Parâmetros:

• audioUrl (string): URL pública do arquivo de áudio.
• language (string, opcional): Código do idioma (ex.: pt-BR, en-US).

Exemplo:

Use a ferramenta analyze-audio com audioUrl="https://exemplo.com/audio.wav"

transcribe

Transcreve um arquivo de áudio para texto.

Parâmetros:

• audioUrl (string): URL pública do arquivo de áudio.
• language (string, opcional): Código do idioma.

assess-pronunciation

Avalia a pronúncia comparando o áudio com um texto de referência.

Parâmetros:

• audioUrl (string): URL pública do arquivo de áudio.
• referenceText (string): Texto-alvo para comparação.
• language (string, opcional): Código do idioma.

compare-prosody

Compara a prosódia entre dois arquivos de áudio.

Parâmetros:

• audioUrl1 (string): URL do primeiro arquivo de áudio.
• audioUrl2 (string): URL do segundo arquivo de áudio.

Variáveis de Ambiente

• VOCAMETRIX_API_KEY (obrigatório): Sua chave de API da Vocametrix.

Documentação

Para documentação completa da API, visite docs.vocametrix.com.

Suporte

Para problemas ou perguntas, abra uma issue no GitHub.