Discord Community MCP

Un servidor local-first del Model Context Protocol que proporciona a los agentes de IA búsqueda en Discord, recuperación de conversaciones, investigación comunitaria y análisis de crecimiento en modo de solo lectura a través de una cuenta de bot. El envío de mensajes y reacciones solo está disponible cuando se habilita explícitamente.

Qué puede hacer

• Encontrar conversaciones a partir de un recuerdo vago, incluso cuando la redacción es incierta

• Reconstruir el contexto en torno a un mensaje coincidente

• Indexar el historial seleccionado de Discord en una base de datos SQLite local

• Analizar actividad, tiempos de respuesta, la participación, la concentración, la reciprocidad y los temas

• Guardar instantáneas de los miembros y analizar las altas, las bajas, los roles y el crecimiento de los contribuidores

• Opcionalmente, enviar mensajes, responder y reaccionar

Related MCP server: Discord MCP Server

Requisitos

• Node.js 22.5 o superior

• Una aplicación de Discord y un token de bot

• Un cliente MCP que admita servidores stdio locales, como Codex

1. Crear un bot de Discord

1. Abre el Discord Developer Portal y crea una aplicación.

2. Ve a Bot, crea el bot y copia su token.

3. En la sección Bot → Privileged Gateway Intents, habilita:

   • Message Content Intent para el texto de los mensajes y la búsqueda

   • Server Members Intent para las instantáneas de los miembros, las fechas de registro, los roles y el crecimiento

4. Presence Intent no es obligatorio.

5. En OAuth2 → URL Generator, selecciona el ámbito bot.

6. Concede al bot los permisos View Channels y Read Message History. Añade Send Messages o Add Reactions solo si tienes previsto activar las herramientas de escritura.

7. Abre la URL generada e invita al bot a tu servidor de Discord.

El bot solo puede acceder a los canales que su rol de Discord tenga permitido ver.

2. Instalación

git clone https://github.com/blackgirlbytes/discord-community-mcp.git
cd discord-community-mcp
npm ci
npm run build
cp .env.example .env

Abre el archivo .env y sustituye el token provisional:

DISCORD_BOT_TOKEN=replace-with-your-bot-token
DISCORD_ENABLE_WRITE=false

Mantén .env privado. Está excluido de git.

3. Añadirlo a un cliente MCP

Codex CLI

Usa rutas absolutas para que el cliente pueda iniciar el servidor desde cualquier directorio:

codex mcp add discord-community -- \
  node \
  --env-file=/absolute/path/to/discord-community-mcp/.env \
  /absolute/path/to/discord-community-mcp/dist/index.js

Reinicia Codex después de añadir el servidor.

Configuración genérica de stdio

Los clientes que usan un objeto JSON mcpServers pueden usar:

{
  "mcpServers": {
    "discord-community": {
      "command": "node",
      "args": [
        "--env-file=/absolute/path/to/discord-community-mcp/.env",
        "/absolute/path/to/discord-community-mcp/dist/index.js"
      ]
    }
  }
}

Reinicia el cliente MCP después de cambiar su configuración. Después puedes pedirle que enumere los servidores y canales de Discord disponibles para el bot.

Preguntas de ejemplo

• "Encuentra la conversación donde alguien dijo que el proceso de incorporación parecía una tarea."

• "¿Qué decidimos la primavera pasada sobre cambiar el nombre de la SDK?"

• "¿Por qué los evaluadores beta tardan tanto en responder? Busca evidencia en los últimos tres meses."

• "¿Cómo ha crecido la comunidad mes a mes y cómo se compara el crecimiento con la participación?"

• "¿Qué preguntas de soporte quedaron sin responder la semana pasada?"

Para un análisis general, el agente debe sincronizar primero los canales y el rango de fechas correspondientes, comprobar la cobertura del índice y luego ejecutar la investigación dentro de la comunidad. Las explicaciones del comportamiento deben presentarse como hipótesis, a menos que los mensajes las respalden directamente.

Herramientas disponibles

Datos y privacidad

El contenido de los mensajes y los datos de membresía se almacenan en texto claro en data/discord-data-history.sqlite de forma predeterminada. Para cambiarla, usa la variable DISCORD_ANALYTICS_DB.

DISCORD_ANALYTICS_DB=/absolute/private/path/discord-analytics.sqlite

• Indexa solo los canales y los rangos de datos necesarios para el análisis.

• Protege y elimina la base de datos de acuerdo con la política de privacidad de tu comunidad.

• Da al bot solo los permisos de Discord que necesita.

• Mantén DISCORD_ENABLE_WRITE=false a menos que quieras enviar contenido intencionado.

• Rota el token del bot inmediatamente si se expone.

Limitaciones del análisis

• Un archivo de mensajes puede mostrar patrones de comportamiento, pero no puede probar por qué la gente se comportó así.

• Los usuarios de Discord pueden responder sin usar la acción de responder, por lo que las métricas de respuesta pueden quedarse corta.

• No se reconstruye la membresía histórica de un rol; los mensajes más antiguos usan el rol observado más reciente.

• Las salidas exactas solo se detectan entre las instantáneosas de miembros guardadas.

• Una única instantánea de miembros no puede recuperar información si gente que abandonó el servidor con anterioridad.

• La búsqueda y el análisis solo cubren canales visibles para el bot el historial que se ha sincronizado.

• No se admiten mensajes directos.

Acceso de escritura

Las herramientas de escritura están registradas, pero bloqueadas de forma predeterminada. Para habilitarlas, actualiza .env:

DISCORD_ENABLE_WRITE=true

El bot también debe tener los permisos de Discord correspondientes. Mantén la escritura deshabilitada en las instalaciones solo de investigación.

Desarrollo

npm ci
npm run check
npm test

El servidor escribe los registros de operación en stderr porque stdout está reservado para el protocolo stdio de MCP.