MCP-Discord

Un servidor MCP (Protocolo de Contexto de Modelo) de Discord que permite a los asistentes de IA interactuar con la plataforma Discord.

Descripción general

MCP-Discord proporciona las siguientes funcionalidades relacionadas con Discord:

• Iniciar sesión en un bot de Discord

• Listar los servidores de los que el bot es miembro

• Obtener información del servidor

• Listar miembros e inspeccionar detalles de los miembros

• Listar, crear, editar, eliminar, asignar y eliminar roles

• Buscar mensajes en un servidor

• Leer, editar y eliminar mensajes de canal

• Enviar mensajes a canales específicos

• Recuperar listas de canales de foro

• Crear, actualizar, eliminar y responder a publicaciones de foro

• Listar hilos de foro y gestionar etiquetas de foro

• Crear, editar y eliminar canales de texto, foro, voz y categorías

• Establecer y eliminar anulaciones de permisos de canal

• Añadir/eliminar reacciones a mensajes

• Crear/editar/eliminar/usar webhooks

Related MCP server: MCP-Discord

Tabla de contenidos

• Requisitos previos

• Instalación

• Configuración

• Documentación de herramientas

  • Funciones básicas

  • Gestión de canales

  • Funciones de foro

  • Mensajes y reacciones

  • Gestión de webhooks

  • Gestión de roles

  • Gestión de miembros

• Desarrollo

• Licencia

Requisitos previos

• Node.js (v18.0.0 o superior)

• npm (v7.0.0 o superior)

• Un bot de Discord con los permisos adecuados

  • Token del bot (se puede obtener en el Portal de desarrolladores de Discord)

  • Intención de contenido de mensaje (Message Content Intent) habilitada

  • Intención de miembros del servidor (Server Members Intent) habilitada

  • Intención de presencia (Presence Intent) habilitada

• Permisos requeridos en tu servidor de Discord:

  Configuración más sencilla

  • Administrador (Recomendado para una configuración rápida y funcionalidad completa)

  O bien, selecciona solo los permisos requeridos:

  • Enviar mensajes

  • Crear hilos públicos

  • Enviar mensajes en hilos

  • Gestionar mensajes

  • Gestionar hilos

  • Gestionar canales

  • Gestionar webhooks

  • Gestionar roles

  • Añadir reacciones

  • Ver canal

• Añade tu bot de Discord a tu servidor

  • Para añadir tu bot de Discord a tu servidor, utiliza uno de los siguientes enlaces de invitación (reemplaza INSERT_CLIENT_ID_HERE con el ID de cliente de tu bot):

    • Administrador (acceso completo): https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=8

    • Permisos personalizados (mínimo requerido): https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=52076489808

Nota: Según el modelo de seguridad de Discord, un bot solo puede acceder a información de servidores a los que ha sido añadido explícitamente. Si deseas utilizar este servidor MCP para acceder a un servidor de Discord específico, primero debes añadir el bot a ese servidor. Utiliza el enlace de invitación a continuación para añadir el bot a tu servidor objetivo.

Instalación

Instalación mediante NPM

Puedes usarlo con el siguiente comando:

npx mcp-discord --config ${DISCORD_TOKEN}

Para más detalles, puedes consultar el paquete NPM.

Instalación mediante Smithery

Para instalar mcp-discord automáticamente mediante Smithery

Instalación mediante Docker

Puedes ejecutar mcp-discord usando Docker. Las imágenes de Docker se crean y publican automáticamente en Docker Hub.

Repositorio de Docker Hub: barryy625/mcp-discord

Docker utiliza el servidor HTTP transmitible por defecto a través de build/app.js.

# Pull the latest image
docker pull barryy625/mcp-discord:latest

# Run HTTP server on port 8080
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 8080:8080 barryy625/mcp-discord:latest

# Override the listening port if needed
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 3000:3000 barryy625/mcp-discord:latest --transport http --port 3000

Etiquetas disponibles:

• latest - Última versión estable de la rama principal

• v1.3.8, etc. - Lanzamientos de versiones específicas

Instalación manual

# Clone the repository
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord

# Install dependencies
npm install

# Compile TypeScript
npm run build

Configuración

Se requiere un token de bot de Discord para un funcionamiento correcto. El servidor admite dos métodos de transporte: stdio y HTTP transmitible.

Métodos de transporte

1. stdio (Predeterminado)

   • Transporte stdio tradicional para uso básico

   • Adecuado para integraciones simples

2. HTTP transmitible

   • Transporte basado en HTTP para escenarios más avanzados

   • Admite operación sin estado

   • Número de puerto configurable

Opciones de configuración

Puedes proporcionar la configuración de dos maneras:

1. Variables de entorno:

DISCORD_TOKEN=your_discord_bot_token

2. Usando argumentos de línea de comandos:

# For stdio transport (default)
node build/index.js --config "your_discord_bot_token"

# For streamable HTTP transport
node build/app.js --transport http --port 3000 --config "your_discord_bot_token"

Uso con Claude/Cursor

1. Usar transporte Stdio con Claude/Cursor

Usa build/index.js cuando tu cliente MCP espere un servidor stdio basado en comandos.

Claude Desktop / Claude Code

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token"
            }
        }
    }
}

Cursor

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token"
            }
        }
    }
}

Esta es la configuración recomendada para clientes MCP locales basados en comandos.

2. Alojar el servidor HTTP transmitible

Usa build/app.js cuando desees ejecutar mcp-discord como un servidor MCP HTTP.

Ejecutar con Node.js

DISCORD_TOKEN=your_discord_bot_token node build/app.js --transport http --port 3000

En Windows PowerShell:

$env:DISCORD_TOKEN="your_discord_bot_token"
node build/app.js --transport http --port 3000

Ejecutar con Docker

docker run -e DISCORD_TOKEN=your_discord_bot_token -p 3000:3000 barryy625/mcp-discord:latest --transport http --port 3000

Una vez iniciado, el punto final HTTP de MCP es:

http://localhost:3000/mcp

3. Conectarse a un servidor MCP HTTP alojado

Si ya alojas mcp-discord en otro lugar, apunta tu cliente MCP al punto final /mcp del servidor en lugar de iniciar build/app.js como un comando.

Ejemplo de punto final:

https://your-server.example.com/mcp

Notas importantes:

• build/app.js inicia un servidor HTTP. No utiliza stdio.

• build/index.js es el punto de entrada correcto para clientes MCP stdio basados en comandos.

• Para el uso de HTTP alojado, configura tu cliente MCP para que se conecte a la URL del punto final HTTP proporcionada por tu despliegue.

• El formato exacto de configuración del cliente HTTP depende del cliente MCP que utilices.

Documentación de herramientas

Funciones básicas

• discord_login: Iniciar sesión en Discord usando el token configurado

• discord_list_servers: Listar todos los servidores de Discord de los que el bot es miembro

• discord_send: Enviar un mensaje a un canal especificado

• discord_get_server_info: Obtener información del servidor de Discord

Gestión de canales

• discord_create_text_channel: Crear un canal de texto

• discord_create_forum_channel: Crear un canal de foro

• discord_create_voice_channel: Crear un canal de voz

• discord_edit_channel: Editar el nombre, tema, categoría principal o posición de un canal

• discord_delete_channel: Eliminar un canal

• discord_create_category: Crear una categoría de canal

• discord_edit_category: Editar una categoría de canal

• discord_delete_category: Eliminar una categoría de canal

• discord_set_channel_permissions: Establecer anulaciones de permisos para un rol o usuario en un canal/categoría

• discord_remove_channel_permissions: Eliminar anulaciones de permisos de un canal/categoría

Funciones de foro

• discord_get_forum_channels: Obtener una lista de canales de foro

• discord_create_forum_post: Crear una publicación en un foro

• discord_get_forum_post: Obtener una publicación de foro

• discord_list_forum_threads: Listar hilos activos y archivados en un canal de foro

• discord_reply_to_forum: Responder a una publicación de foro

• discord_get_forum_tags: Obtener todas las etiquetas disponibles para un canal de foro

• discord_set_forum_tags: Reemplazar las etiquetas disponibles para un canal de foro

• discord_update_forum_post: Actualizar el título, las etiquetas, el estado archivado o el estado bloqueado de una publicación de foro

• discord_delete_forum_post: Eliminar una publicación de foro

Mensajes y reacciones

• discord_search_messages: Buscar mensajes en un servidor

• discord_read_messages: Leer mensajes de canal (admite parámetros before, after, around — acepta IDs snowflake o fechas ISO 8601 como "2025-03-01T00:00:00Z")

• discord_edit_message: Editar un mensaje escrito por el bot

• discord_add_reaction: Añadir una reacción a un mensaje

• discord_add_multiple_reactions: Añadir múltiples reacciones a un mensaje

• discord_remove_reaction: Eliminar una reacción de un mensaje

• discord_delete_message: Eliminar un mensaje específico de un canal

Gestión de webhooks

• discord_create_webhook: Crea un nuevo webhook para un canal de Discord

• discord_send_webhook_message: Envía un mensaje a un canal de Discord usando un webhook

• discord_edit_webhook: Edita un webhook existente para un canal de Discord

• discord_delete_webhook: Elimina un webhook existente para un canal de Discord

Gestión de roles

• discord_list_roles: Listar todos los roles en un servidor

• discord_create_role: Crear un rol con opciones de color, hoist, mencionable y permisos

• discord_edit_role: Editar un rol existente

• discord_delete_role: Eliminar un rol

• discord_assign_role: Asignar un rol a un miembro

• discord_remove_role: Eliminar un rol de un miembro

Gestión de miembros

• discord_list_members: Listar miembros en un servidor con roles

• discord_get_member: Obtener información detallada sobre un miembro específico

Desarrollo

# Development mode
npm run dev

Licencia

Licencia MIT