discord-mcp

@spranab/discord-mcp

Moderar um servidor Discord significa clicar: abrir o servidor, encontrar o canal, rolar até a mensagem, abrir a lista de membros, aplicar o timeout, anotar em algum lugar. Todo servidor MCP do Discord que expõe uma ferramenta por operação também custa milhares de tokens de contexto antes de o modelo ler a sua pergunta.

Este dá a um assistente de IA o servidor inteiro — mais de 30 ações em mensagens, canais, cargos, membros, moderação, threads, webhooks, convites, emojis e o registro de auditoria — por trás de uma única ferramenta discord com descoberta em três níveis, para que o modelo pague apenas pelas ações que usa e nada mais.

Instalação (60 segundos)

Claude Code — adicione ao seu .mcp.json:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@spranab/discord-mcp"],
      "env": { "bot_token": "YOUR_BOT_TOKEN" }
    }
  }
}

Precisa de um token de bot? Veja Configuração do Bot do Discord abaixo — cerca de dois minutos no Portal do Desenvolvedor.

Como é na prática

Você: "Alguém está enviando spam no #geral. Limpe as últimas 20 mensagens lá, aplique timeout nesse usuário por uma hora e registre para os moderadores."

→ discord(category: "messages", action: "bulk_delete",
          params: { channel_id: "9876...", count: 20 })
→ discord(category: "moderation", action: "timeout",
          params: { guild_id: "1234...", user_id: "5555...",
                    duration_minutes: 60, reason: "Spam in #general" })
→ discord(category: "messages", action: "send",
          params: { channel_id: "4321...",
                    content: "Timed out spammer (1h), cleared 20 messages in #general" })

O modelo encontrou bulk_delete e timeout chamando discord() e depois discord(category: "moderation") — ele nunca teve mais de 30 esquemas de ferramentas no prompt. Os IDs de canal e usuário vêm de channels: list e members: list da mesma forma.

Recursos

Uma ferramenta discord com 11 categorias e mais de 30 ações:

Categoria	Ações	Descrição
servidor	list, info	Listar servidores, obter detalhes do servidor
canais	list, create, edit, delete	Gerenciamento completo de canais
mensagens	send, read, edit, delete, bulk_delete, pin, react, search	Enviar, ler, moderar mensagens
cargos	list, create, edit, delete, assign	CRUD de cargos + atribuição
membros	list, info, nickname	Listagem e gerenciamento de membros
moderação	kick, ban, unban, timeout, list_bans	Moderação do servidor
threads	create	Criação de threads
webhooks	list, create	Gerenciamento de webhooks
convites	create, list	Gerenciamento de convites
emojis	list	Listagem de emojis personalizados
auditoria	log	Acesso ao registro de auditoria

Como Funciona

A ferramenta usa navegação em 3 níveis para manter sua lista de ferramentas limpa:

discord()                                          → list categories
discord(category="messages")                       → list actions & params
discord(category="messages", action="send", params={...}) → execute

Outros clientes

Mesma estrutura JSON para Cursor, Windsurf, Claude Desktop e Cline:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@spranab/discord-mcp"],
      "env": {
        "bot_token": "YOUR_BOT_TOKEN"
      }
    }
  }
}

Manual

npm install -g @spranab/discord-mcp

Execute com a variável de ambiente bot_token definida:

bot_token=YOUR_BOT_TOKEN discord-mcp

Configuração do Bot do Discord

1. Acesse o Portal do Desenvolvedor do Discord
2. Crie um novo aplicativo
3. Vá em Bot e copie o token
4. Ative os Privileged Gateway Intents (todos os três):
   • Presence Intent
   • Server Members Intent
   • Message Content Intent
5. Vá em Installation > Default Install Settings > Guild Install
6. Adicione o escopo bot e selecione as permissões Administrator
7. Use o link de instalação para adicionar o bot ao seu servidor

Stack Tecnológica

• TypeScript
• discord.js v14
• MCP SDK
• Zod para validação

Projetos relacionados

Outros servidores MCP e infraestrutura de agentes do mesmo autor:

• saga-mcp — rastreador de projetos com SQLite para o agente não perder o plano entre sessões.
• yantrikdb-mcp — memória cognitiva persistente para Claude Code, Cursor e Windsurf.
• truenas-mcp — 278 ações do TrueNAS SCALE atrás do mesmo padrão de ferramenta única usado aqui.
• brainstorm-mcp — debate multimodelo como ferramenta MCP.
• swarmcode — canal em tempo real entre instâncias do Claude Code em máquinas diferentes.

Licença

MIT — veja LICENSE.