Nika — Discord MCP Server

Un servidor integral de Model Context Protocol que permite a los asistentes de IA gestionar una comunidad de Discord: mensajería, moderación, roles, canales, foros, webhooks, invitaciones, eventos programados, AutoMod, incorporación, emojis/pegatinas, sobrescrituras de permisos, gestión de voz — 111 herramientas, además de un paso directo REST (discord_api_request) para que cualquier cosa que la API de Discord pueda hacer sea accesible.

Construido con Python + discord.py (conexión persistente de gateway) y FastMCP.

Configuración

1. Crear el bot de Discord (hecho)

• Aplicación: Nika (ID 1538805149865091092)

• Intents habilitados: Server Members, Message Content

• Token: almacenado en .env (nunca lo subas al repositorio — .gitignore lo protege)

2. Invita al bot a tu servidor

Abre esta URL y elige tu servidor (otorga Administrador para obtener toda la funcionalidad):

https://discord.com/api/oauth2/authorize?client_id=1538805149865091092&permissions=8&scope=bot%20applications.commands

⚠️ El bot debe estar en un servidor antes de que la mayoría de las herramientas puedan hacer algo.

3. Instalar y configurar

python -m venv .venv
.venv\Scripts\pip install -e ".[dev]"

.env (ya creado):

DISCORD_TOKEN=...            # bot token
DISCORD_GUILD_ID=            # optional: default server id → makes guildId optional everywhere
MCP_TRANSPORT=stdio          # stdio | http
HTTP_HOST=0.0.0.0            # HTTP mode only
HTTP_PORT=8085
LOG_LEVEL=INFO

Related MCP server: Cloud Discord

Uso

stdio (por defecto — Claude Desktop, VS Code, Cursor, etc.)

.venv\Scripts\python -m discord_mcp

Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "nika": {
      "command": "d:\\Projects\\david\\DiscordMCP\\.venv\\Scripts\\python.exe",
      "args": ["-m", "discord_mcp"],
      "cwd": "d:\\Projects\\david\\DiscordMCP"
    }
  }
}

HTTP (streamable) — acceso remoto, n8n, multi-cliente

.venv\Scripts\python -m discord_mcp --transport http --port 8085
# endpoint: http://localhost:8085/mcp

Configuración del cliente:

{
  "mcpServers": {
    "nika": { "url": "http://localhost:8085/mcp" }
  }
}

Docker

docker compose up -d            # builds + runs HTTP mode on :8085
docker run -i --rm -e DISCORD_TOKEN=$env:DISCORD_TOKEN discord-mcp:latest   # stdio

Pruebas con el MCP Inspector

npx @modelcontextprotocol/inspector .venv\Scripts\python.exe -m discord_mcp

Referencia de herramientas (111 herramientas)

Notas de diseño

• Gateway híbrido + REST: una conexión persistente de gateway de discord.py proporciona estado en vivo (búsquedas de miembros/canales, nombres→IDs) mientras que las mutaciones pasan por el mismo cliente. Las llamadas de herramientas se conectan al bucle del gateway mediante asyncio.run_coroutine_threadsafe.

• Seguridad: la herramienta raw requiere confirmDestructive=true para métodos mutadores; prune_members por defecto es una ejecución de prueba (dry run); las herramientas destructivas aceptan un reason que se escribe en el registro de auditoría.

• guildId opcional: establece DISCORD_GUILD_ID en .env y cada parámetro guildId pasa a ser opcional.

• Errores: los errores de Discord se convierten en mensajes legibles (p. ej., Missing permissions: ...).

Limitaciones

• Requiere un token de bot (la automatización con token de usuario/self-bot viola los Términos de Servicio de Discord).

• La lectura de mensajes requiere que el bot vea el canal y (para el contenido) el intent de Message Content.

• No hay transmisión/recepción de audio de voz.

Desarrollo

.venv\Scripts\python -m pytest        # 22 unit tests

Estructura: discord_mcp/bot.py (puente de gateway) · discord_mcp/server.py (FastMCP) · discord_mcp/tools/*.py (un módulo por dominio) · discord_mcp/utils/ (serializadores, embeds).

Licencia

MIT