Discord MCP Server

Comunicação de Agente MCP Discord

Um servidor MCP (Model Context Protocol) que permite comunicação assíncrona entre agentes de IA e usuários via Discord. Perfeito para tarefas de IA de longa duração onde você precisa de capacidades de interação remota.

🎯 Propósito

Este não é um bot completo do Discord - é especificamente projetado para agentes de IA se comunicarem com usuários remotamente durante tarefas de longa duração. Afaste-se da sua máquina enquanto seu assistente de IA lida com trabalhos complexos e entra em contato quando necessário.

Recursos

• 💬 Comunicação Unificada - Ferramenta única para todas as interações no Discord
• 📢 Enviar Notificações - O agente envia atualizações sem esperar resposta
• 🔄 Solicitar Entrada do Usuário - O agente faz perguntas e aguarda respostas
• ⏰ Comunicação Assíncrona - Perfeito para tarefas de longa duração que exigem interação remota

Casos de Uso

Perfeito para cenários onde agentes de IA precisam de interação humana remota:

• Inicie tarefas complexas e seja notificado quando elas forem concluídas
• Deixe a IA pedir sua opinião ou feedback quando decisões forem necessárias
• Fique por dentro enquanto faz outras atividades (treinos, caminhadas, reuniões)
• Monitore o progresso sem ficar grudado na tela

Configuração Rápida

1. Criar Bot do Discord

1. Vá para Portal do Desenvolvedor do Discord
2. Crie "Nova Aplicação" → Vá para "Bot" → "Adicionar Bot"
3. Copie o token do bot
4. Ative "MESSAGE CONTENT INTENT" nas configurações do bot
5. Use o Gerador de URL OAuth2 para convidar o bot para o seu servidor com estas permissões:
   • Enviar Mensagens, Ler Histórico de Mensagens, Adicionar Reações, Ver Canais

2. Obter ID do Canal

Ative o Modo de Desenvolvedor nas configurações do Discord, depois clique com o botão direito no seu canal → "Copiar ID do Canal"

3. Configurar o Claude Desktop

Adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "discord-agent-comm": {
      "command": "npx",
      "args": ["mcp-discord-agent-comm"],
      "env": {
        "DISCORD_BOT_TOKEN": "your-bot-token-here",
        "DISCORD_CHANNEL_ID": "your-channel-id-here"
      }
    }
  }
}

Ferramenta Disponível

discord_message

Envie uma mensagem para o Discord, opcionalmente aguardando uma resposta.

Notificação simples (sem necessidade de resposta):

{
  "message": "Task completed! 🎉"
}

Solicitar entrada do usuário (aguarda resposta):

{
  "message": "What should I name this file?",
  "expect_reply": true
}

Sim/Não ou qualquer outra pergunta (aguarda resposta):

{
  "message": "Should I deploy to production?",
  "expect_reply": true
}

Nota: Quando expect_reply for verdadeiro, a ferramenta aguarda o usuário responder à mensagem no Discord.

Instruções para o Agente

Para orientação sobre como instruir agentes de IA a usar essas ferramentas de forma eficaz, veja AGENT_INSTRUCTIONS.md. Ele fornece diretrizes de exemplo sobre quando os agentes devem se comunicar vs. trabalhar de forma autônoma.

Notas Importantes

Notificações do Discord

• Apenas um dispositivo recebe notificações do Discord - desative o Discord em outros dispositivos ou desligue as notificações se quiser recebê-las em um dispositivo específico
• As notificações funcionam melhor em dispositivos móveis quando outras instâncias estão fechadas

Como Funciona

• Notificações: Mensagem direta para o canal (quando expect_reply for falso ou omitido)
• Solicitações de entrada: Os usuários respondem à mensagem do bot usando o recurso de resposta do Discord (quando expect_reply for verdadeiro)
• Tempo limite padrão: 300 segundos (5 minutos) ao aguardar respostas

Solução de Problemas

• Bot offline: Verifique o token e as permissões
• Sem notificações: Certifique-se de que MESSAGE CONTENT INTENT esteja ativado, verifique as permissões do canal
• Tempos limite: Os usuários devem responder às mensagens (não apenas digitar no canal) ou clicar em reações

Desenvolvimento

git clone https://github.com/EugenEistrach/mcp-discord-agent-comm.git
cd mcp-discord-agent-comm
bun install
cp .env.example .env  # Edit with your tokens
bun run dev

Licença

MIT

Status de Publicação

Instale globalmente: npm install -g mcp-discord-agent-comm