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

Related MCP server: MCP-Discord

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 :

npx -y @smithery/cli install @barryyip0625/mcp-discord --client claude

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. Puedes proporcionarlo de dos maneras:

1. Variables de entorno:

DISCORD_TOKEN=your_discord_bot_token
DEFAULT_SERVER_ID=your_default_server_id  # Optional
DEFAULT_CHANNEL_ID=your_default_channel_id  # Optional

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

node path/to/mcp-discord/build/index.js --config "{\"DISCORD_TOKEN\":\"your_discord_bot_token\"}"

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:

node start-discord.js

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

# Development mode
npm run dev

Licencia

Licencia MIT