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 el bot de Discord

• Obtener información del servidor

• Leer/eliminar mensajes del canal

• Enviar mensajes a canales específicos

• Recuperar listas de canales del foro

• Crear/eliminar/responder publicaciones del foro

• Crear/eliminar canales de texto

• Agregar o eliminar reacciones de mensajes

• Crear/editar/eliminar/utilizar webhooks

Tabla de contenido

• Prerrequisitos

• Instalación

• Configuración

• Documentación de herramientas

  • Funciones básicas

  • Gestión de canales

  • Funciones del foro

  • Mensajes y reacciones

  • Gestión de webhooks

• Desarrollo

• Licencia

Prerrequisitos

• Node.js (v16.0.0 o superior)

• npm (v7.0.0 o superior)

• Un bot de Discord con los permisos adecuados

  • Token de bot (obtenible en el Portal para desarrolladores de Discord )

  • Intención de contenido del mensaje habilitada

  • Intención de miembros del servidor habilitada

  • Intención de presencia habilitada

• Permisos en tu servidor de Discord:

  • Enviar mensajes

  • Crear hilos públicos

  • Enviar mensajes en hilos

  • Administrar hilos

  • Administrar canales

  • Agregar reacciones

Instalación

Instalación mediante herrería

Para instalar mcp-discord para Claude Desktop automáticamente a través de Smithery :

Instalación manual

Configuración

Se requiere un token de bot de Discord para un funcionamiento correcto. Puedes proporcionarlo de dos maneras:

1. Variables de entorno:

2. Usando el parámetro --config al iniciar:

Script de inicio mejorado

El proyecto incluye un script de inicio mejorado ( start-discord.js ) que proporciona una mejor depuración y manejo de errores:

• Carga variables de entorno desde el archivo .env

• Establece los identificadores de servidor y canal predeterminados si no se proporcionan

• Redirige console.log a stderr para evitar problemas de análisis de JSON en Claude Desktop

• Prueba la conexión de Discord directamente antes de iniciar el servidor MCP

• Proporciona información detallada de errores si algo sale mal.

Para utilizar este script:

Uso con Claude/Cursor

• Claude

  { "mcpServers": { "discord": { "command": "node", "args": [ "path/to/mcp-discord/start-discord.js" ], "env": { "DISCORD_TOKEN": "your_discord_bot_token", "DEFAULT_SERVER_ID": "your_default_server_id", "DEFAULT_CHANNEL_ID": "your_default_channel_id" } } } }

• Cursor

  { "mcpServers": { "discord": { "command": "cmd", "args": [ "/c", "node", "path/to/mcp-discord/start-discord.js" ], "env": { "DISCORD_TOKEN": "your_discord_bot_token", "DEFAULT_SERVER_ID": "your_default_server_id", "DEFAULT_CHANNEL_ID": "your_default_channel_id" } } } }

Documentación de herramientas

Funciones básicas

• discord_login : Iniciar sesión en Discord

• discord_list_guilds : Lista todos los servidores de Discord (gremios) disponibles con sus canales

• discord_send : envía un mensaje a un canal específico

• discord_get_server_info : Obtener información del servidor de Discord

Gestión de canales

• discord_create_text_channel : Crea un canal de texto

• discord_delete_channel : Eliminar un canal

Funciones del foro

• discord_get_forum_channels : Obtener una lista de canales del foro

• discord_create_forum_post : Crea una publicación en el foro

• discord_get_forum_post : Obtener una publicación en el foro

• discord_reply_to_forum : Responder a una publicación del foro

• discord_delete_forum_post : Eliminar una publicación del foro

Mensajes y reacciones

• discord_read_messages : Leer mensajes del canal

• discord_add_reaction : Agregar una reacción a un mensaje

• discord_add_multiple_reactions : Agrega 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

Desarrollo

Licencia

Licencia MIT