Discord MCP

📖 Descrição

Um servidor Model Context Protocol (MCP) para a API do Discord usando (JDA), projetado para integrar bots do Discord com aplicativos compatíveis com MCP, como Claude, ChatGPT, etc. Ele permite que assistentes de IA interajam com o Discord gerenciando canais, enviando mensagens e recuperando informações do servidor. Ideal para construir automação poderosa do Discord e fluxos de trabalho orientados por IA.

🔬 Instalação

► 🐳 Instalação via Docker (Recomendado)

[!NOTE] A instalação do Docker é necessária. Instruções completas podem ser encontradas em docker.com.

1) Defina as variáveis de ambiente locais

export DISCORD_TOKEN="YOUR_DISCORD_BOT_TOKEN"
export DISCORD_GUILD_ID="OPTIONAL_DEFAULT_SERVER_ID"
export SPRING_PROFILES_ACTIVE=http

[!IMPORTANT] Instruções para criar um bot do Discord e recuperar seu token podem ser encontradas aqui.

[!TIP] A variável de ambiente DISCORD_GUILD_ID é opcional.

Quando fornecida, ela define um ID de servidor Discord padrão para que qualquer ferramenta que aceite um parâmetro guildId possa omiti-lo.

2) Execute o contêiner Docker

docker run -d -i \
  --name discord-mcp \
  --restart unless-stopped \
  -p 8085:8085 \
  -e SPRING_PROFILES_ACTIVE \
  -e DISCORD_TOKEN \
  -e DISCORD_GUILD_ID \
  saseq/discord-mcp:latest

URL padrão do endpoint MCP (perfil HTTP): http://localhost:8085/mcp

git clone https://github.com/SaseQ/discord-mcp

cd discord-mcp

cat > .env <<EOF
SPRING_PROFILES_ACTIVE=http
DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>
DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>
EOF

docker compose up -d --build

docker ps --filter name=discord-mcp
curl -fsS http://localhost:8085/actuator/health

git clone https://github.com/SaseQ/discord-mcp

cd discord-mcp
mvn clean package # The jar file will be available in the /target directory

DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN> \
DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID> \
SPRING_PROFILES_ACTIVE=http \
java -jar /absolute/path/to/discord-mcp-1.0.0.jar

🔗 Conexões

► 🗞️ Conexão padrão config.json

Recomendado (modo singleton HTTP):

{
  "mcpServers": {
    "discord-mcp": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

Modo legado (stdio, inicia um novo processo/contêiner por sessão de cliente):

{
  "mcpServers": {
    "discord-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e",
        "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

claude mcp add discord-mcp --transport http http://localhost:8085/mcp

claude mcp add discord-mcp -- docker run --rm -i -e DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN> -e DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID> saseq/discord-mcp:latest

codex mcp add discord-mcp --url http://localhost:8085/mcp
codex mcp list

openclaw mcp set discord-mcp '{"url":"http://localhost:8085/mcp","transport":"streamable-http"}'
openclaw mcp list

{
  "mcp": {
    "servers": {
      "discord-mcp": {
        "url": "http://localhost:8085/mcp",
        "transport": "streamable-http"
      }
    }
  }
}

{
  "mcpServers": {
    "discord-mcp": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

{
  "mcpServers": {
    "discord-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e",
        "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

🛠️ Ferramentas Disponíveis

Informações do Servidor

• get_server_info: Obtenha informações detalhadas do servidor Discord

Gerenciamento de Usuários

• get_user_id_by_name: Obtenha o ID de um usuário do Discord pelo nome de usuário em um servidor para uso em menções <@id>
• send_private_message: Envie uma mensagem privada para um usuário específico
• edit_private_message: Edite uma mensagem privada de um usuário específico
• delete_private_message: Exclua uma mensagem privada de um usuário específico
• read_private_messages: Leia o histórico de mensagens privadas de um usuário específico (inclui metadados de anexos, suporta count 1-100 e cursor opcional: before ou after ou around)

Gerenciamento de Mensagens

• send_message: Envie uma mensagem para um canal específico
• edit_message: Edite uma mensagem de um canal específico
• delete_message: Exclua uma mensagem de um canal específico
• read_messages: Leia o histórico de mensagens de um canal específico (inclui metadados de anexos, suporta count 1-100 e cursor opcional: before ou after ou around)
• add_reaction: Adicione uma reação (emoji) a uma mensagem específica
• remove_reaction: Remova uma reação especificada (emoji) de uma mensagem

Gerenciamento de Canais

• create_text_channel: Crie um novo canal de texto
• edit_text_channel: Edite configurações de um canal de texto (nome, tópico, nsfw, slowmode, categoria, posição)
• delete_channel: Exclua um canal
• find_channel: Encontre o tipo e o ID de um canal usando nome e ID do servidor
• list_channels: Lista de todos os canais
• get_channel_info: Obtenha informações detalhadas sobre um canal
• move_channel: Mova um canal para outra categoria e/ou altere sua posição

Gerenciamento de Categorias

• create_category: Crie uma nova categoria para canais
• edit_category: Edite uma categoria (renomeie ou mova a posição)
• delete_category: Exclua uma categoria
• find_category: Encontre o ID de uma categoria usando nome e ID do servidor
• list_channels_in_category: Lista de canais em uma categoria específica

Gerenciamento de Webhooks

• create_webhook: Crie um novo webhook em um canal específico
• delete_webhook: Exclua um webhook
• list_webhooks: Lista de webhooks em um canal específico
• send_webhook_message: Envie uma mensagem via webhook

Gerenciamento de Cargos

• list_roles: Obtenha uma lista de todos os cargos no servidor com seus detalhes
• create_role: Crie um novo cargo no servidor
• edit_role: Modifique as configurações de um cargo existente
• delete_role: Exclua permanentemente um cargo do servidor
• assign_role: Atribua um cargo a um usuário
• remove_role: Remova um cargo de um usuário

Moderação e Gerenciamento de Usuários

• kick_member: Expulsa um membro do servidor
• ban_member: Bane um usuário do servidor
• unban_member: Remove um banimento de um usuário
• timeout_member: Desabilita a comunicação de um membro por uma duração especificada
• remove_timeout: Remove um timeout (desmutar) de um membro antes que expire
• set_nickname: Altera o apelido de um membro no servidor
• get_bans: Retorna uma lista de usuários banidos no servidor com os motivos do banimento

Gerenciamento de Canais de Voz e Stage

• create_voice_channel: Crie um novo canal de voz em um servidor
• create_stage_channel: Crie um novo canal de stage para eventos de áudio
• edit_voice_channel: Edite configurações de um canal de voz ou stage (nome, bitrate, limite de usuários, região)
• move_member: Mova um membro para outro canal de voz
• disconnect_member: Desconecte um membro do seu canal de voz atual
• modify_voice_state: Mute ou ensurdeça um membro no servidor em canais de voz

Gerenciamento de Eventos Agendados

• create_guild_scheduled_event: Agende um novo evento no servidor (voz, stage ou externo)
• edit_guild_scheduled_event: Modifique detalhes do evento ou altere seu status (iniciar, concluir, cancelar)
• delete_guild_scheduled_event: Exclua permanentemente um evento agendado
• list_guild_scheduled_events: Liste todos os eventos ativos e agendados no servidor
• get_guild_scheduled_event_users: Obtenha a lista de usuários interessados em um evento agendado

Substituições de Permissão de Canal

• list_channel_permission_overwrites: Liste todas as substituições de permissão para um canal com detalhamento de cargos/membros
• upsert_role_channel_permissions: Crie ou atualize a substituição de permissão para um cargo em um canal
• upsert_member_channel_permissions: Crie ou atualize a substituição de permissão para um membro em um canal
• delete_channel_permission_overwrite: Exclua uma substituição de permissão para um cargo ou membro de um canal

Gerenciamento de Convites

• create_invite: Crie um novo link de convite para um canal específico
• list_invites: Liste todos os convites ativos no servidor com suas estatísticas
• delete_invite: Exclua (revogue) um convite para que o link pare de funcionar
• get_invite_details: Obtenha detalhes sobre um convite específico (funciona para qualquer convite público)

Gerenciamento de Fóruns

• create_forum_channel: Crie um novo canal de fórum
• edit_forum_channel: Edite configurações de um canal de fórum (nome, tópico, nsfw, slowmode, categoria, posição, ordenação padrão, layout padrão)
• list_forum_channels: Liste todos os canais de fórum no servidor
• get_forum_channel_info: Obtenha informações detalhadas sobre um canal de fórum, incluindo tags e configurações
• list_forum_tags: Liste todas as tags disponíveis em um canal de fórum
• create_forum_post: Crie uma nova postagem de fórum (thread) com uma mensagem inicial em um canal de fórum
• list_forum_posts: Liste postagens ativas (threads) em um canal de fórum
• modify_forum_post: Modifique uma postagem de fórum: bloquear/desbloquear, arquivar/desarquivar, fixar/desafixar ou alterar tags aplicadas

Gerenciamento de Emojis

• list_emojis: Liste todos os emojis personalizados no servidor
• get_emoji_details: Obtenha informações detalhadas sobre um emoji personalizado específico
• create_emoji: Envie um novo emoji personalizado para o servidor (base64 ou URL de imagem, máx. 256KB)
• edit_emoji: Edite o nome de um emoji existente ou restrições de cargo
• delete_emoji: Exclua permanentemente um emoji personalizado do servidor

Se DISCORD_GUILD_ID estiver definido, o parâmetro guildId se torna opcional para todas as ferramentas acima.

Exemplos mais detalhados podem ser encontrados na Wiki.