🎙️ MCP Server Audio Summary

Model Context Protocol (MCP) server that adds audio superpowers to your AI. Summarize tasks and hear them spoken using Coqui TTS (Open Source) or ElevenLabs.

🇧🇷 Português

Servidor MCP que fornece ferramentas para sumarização de tarefas e geração de áudio.

🚀 Instalação Rápida

Você não precisa baixar o código manualmente. Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "audio-summary": {
      "command": "npx",
      "args": ["-y", "mcp-server-audio-summary"],
      "env": {
        "OPENAI_API_KEY": "sua_chave_aqui",
        "ELEVENLABS_API_KEY": "opcional_aqui",
        "DEFAULT_TTS_ENGINE": "coqui"
      }
    }
  }
}

🛠️ Configuração do Coqui TTS (Open Source)

Para usar áudio 100% local e gratuito, execute o setup na pasta do seu projeto:

npx mcp-server-audio-summary-setup

(Ou use o script setup-coqui-tts.sh incluído no pacote).

🇺🇸 English

MCP Server providing tools for task summarization and audio feedback using modern TTS engines.

🚀 Quick Start

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "audio-summary": {
      "command": "npx",
      "args": ["-y", "mcp-server-audio-summary"],
      "env": {
        "OPENAI_API_KEY": "your_key_here",
        "ELEVENLABS_API_KEY": "optional_here",
        "DEFAULT_TTS_ENGINE": "coqui"
      }
    }
  }
}

🔧 Features

• summarizeTask: Generates a smart summary of completed work.
• generateAudio: Converts text to speech (supports ElevenLabs & Coqui).
• ambientSound: Play background focus sounds (lofi, rain, etc).
• watchBuild: Audio notification when your long builds finish.

⚙️ Environment Variables / Variáveis de Ambiente

| Variable | Description | |----------|-------------| | OPENAI_API_KEY | Required for summaries / Obrigatória para resumos | | ELEVENLABS_API_KEY | Optional for high quality voice / Opcional para voz HD | | DEFAULT_TTS_ENGINE | coqui or elevenlabs | | AUTO_PLAY_ENABLED | true or false |

🤝 Contribuição / Contributing

🇧🇷 Como contribuir:

1. Faça um Fork do projeto.
2. Crie uma Branch para sua feature (git checkout -b feature/nova-ferramenta).
3. Faça o Commit de suas alterações.
4. Abra um Pull Request.

Adoramos receber novas ferramentas, correções de bugs e sugestões de áudio!

🇺🇸 How to contribute:

1. Fork the project.
2. Create your feature Branch (git checkout -b feature/new-tool).
3. Commit your changes.
4. Open a Pull Request.

We love receiving new tools, bug fixes, and audio suggestions!

📄 License

MIT © 2026