Sound Effects MCP

Sound Effects MCP 🎵

Um servidor MCP que reproduz efeitos sonoros para diversas situações.

Recursos

• 🎵 3 tipos de efeitos sonoros (conclusão, som de Newtype, som de erro)
• 🚀 Integração com Claude Desktop
• 🛠️ Ferramenta MCP simples
• 🎯 Equilíbrio entre produtividade e entretenimento

Como usar

Uso via Claude Code

Adicione este MCP no nível do projeto no Claude Code:

claude mcp add sound-effects-mcp -s project -- npx -y sound-effects-mcp

[!WARNING] Em alguns ambientes, npx pode não ser encontrado. Nesse caso, verifique o caminho completo com which npx e use-o:

# Verifique o caminho completo do npx
which npx

# Use o caminho completo (exemplo)
claude mcp add sound-effects-mcp -s project -- /usr/local/bin/npx -y sound-effects-mcp

Integração com Claude Desktop

Adicione o seguinte ao arquivo de configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sound-effects-mcp": {
      "command": "npx",
      "args": ["-y", "sound-effects-mcp"]
    }
  }
}

Ferramentas disponíveis

play-sound-effect

Reproduz vários efeitos sonoros.

Parâmetros:

• sound (obrigatório): Tipo de efeito sonoro
  • complete: Som de conclusão (melodia)
  • newtype: Som de Newtype (cu-piín)
  • error: Som de erro (alerta)
• message (opcional): Mensagem

Exemplo de uso:

play-sound-effect を使って、complete音でタスク完了を知らせてください

list-sound-effects

Exibe a lista de efeitos sonoros disponíveis.

Exemplo de uso:

list-sound-effects で効果音一覧を見せてください

Configuração de prompt útil

Adicione o seguinte ao arquivo CLAUDE.md do Claude Code para reproduzir efeitos sonoros automaticamente nos momentos adequados:

# サウンドエフェクト
- タスクやプロジェクトが完了した時は `play-sound-effect` の `complete` 音を再生してください
- 問題の原因が特定できた時は `play-sound-effect` の `newtype` 音を再生してください
- 重要な気づきやひらめきがあった時は `play-sound-effect` の `newtype` 音を再生してください

Plataformas suportadas

• macOS: Reproduz arquivos de áudio (MP3) usando o comando afplay

Os arquivos de áudio são baixados automaticamente na primeira execução e salvos no diretório temporário.

Casos de uso

Este servidor MCP pode ser utilizado nas seguintes situações:

• Som de conclusão: Conclusão de projeto, término de processamento longo, conclusão de tarefas
• Som de Newtype: Conquistas especiais, momentos de insight, quando a causa de um problema é identificada (elemento de piada)
• Som de erro: Quando ocorre um erro, alertas, situações que exigem atenção

É uma ferramenta que combina aumento de produtividade e diversão.

Informações para desenvolvedores

Para desenvolvimento e contribuições, consulte CONTRIBUTING.md.

Licença

Licença MIT