MCP-Discord

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