Servidor MCP de la API de Discord Raw

Este servidor MCP proporciona acceso directo a la API de Discord mediante una única herramienta flexible. Admite llamadas a la API REST y la sintaxis de comandos slash.

Instalación

Instalación mediante herrería

Para instalar Discord Raw API para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

Configura tu bot de Discord:
- Crea una nueva aplicación en el Portal para desarrolladores de Discord
- Crea un bot y copia el token
- Habilitar intenciones privilegiadas requeridas:
  - INTENCIÓN DEL CONTENIDO DEL MENSAJE
  - INTENCIÓN DE PRESENCIA
  - INTENCIÓN DE LOS MIEMBROS DEL SERVIDOR
- Invita al bot a tu servidor usando el generador de URL OAuth2
Clonar e instalar el paquete:

# Clone the repository
git clone https://github.com/hanweg/mcp-discord-raw.git
cd mcp-discord-raw

# Create and activate virtual environment
uv venv
.venv\Scripts\activate

### If using Python 3.13+ - install audioop library: `uv pip install audioop-lts`

# Install the package
uv pip install -e .

Configuración

Agregue esto a su claude_desktop_config.json

    "discord-raw": {
      "command": "uv",
      "args": [
        "--directory", 
        "PATH/TO/mcp-discord-raw",
        "run",
        "discord-raw-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR-BOT-TOKEN"
      }
    }

Uso

Estilo de API REST

{
    "method": "POST",
    "endpoint": "guilds/123456789/roles",
    "payload": {
        "name": "Bot Master",
        "permissions": "8",
        "color": 3447003,
        "mentionable": true
    }
}

Estilo de comando de barra

{
    "method": "POST",
    "endpoint": "/role create name:Bot_Master color:blue permissions:8 mentionable:true guild_id:123456789"
}

Ejemplos

Crear un rol:

{
    "method": "POST",
    "endpoint": "/role create name:Moderator color:red permissions:moderate_members guild_id:123456789"
}

Enviar un mensaje:

{
    "method": "POST",
    "endpoint": "channels/123456789/messages",
    "payload": {
        "content": "Hello from the API!"
    }
}

Obtener información del servidor:

{
    "method": "GET",
    "endpoint": "guilds/123456789"
}

Recomendaciones:

Coloque los identificadores de servidor, canal y usuario y algunos ejemplos en el conocimiento del proyecto para evitar tener que recordarle al modelo sobre ellos, junto con algo como esto para comenzar:

A continuación, se explica cómo usar eficazmente la herramienta Discord Raw API: La herramienta se llama discord_api y acepta tres parámetros:

método: método HTTP ("GET", "POST", "PUT", "PATCH", "DELETE")
punto final: punto final de la API de Discord (por ejemplo, "guilds/{guild.id}/roles")
carga útil: objeto JSON opcional para el cuerpo de la solicitud Ejemplos clave que he utilizado:
Creación de roles:

discord_api
method: POST
endpoint: guilds/{server_id}/roles
payload: {
    "name": "Role Name",
    "color": 3447003,  // Blue color in decimal
    "mentionable": true
}

Creación de categorías y canales:

// Category
discord_api
method: POST
endpoint: guilds/{server_id}/channels
payload: {
    "name": "Category Name",
    "type": 4  // 4 = category
}
// Text channel in category
discord_api
method: POST
endpoint: guilds/{server_id}/channels
payload: {
    "name": "channel-name",
    "type": 0,  // 0 = text channel
    "parent_id": "category_id",
    "topic": "Channel description"
}

Mover canales a categorías:

discord_api
method: PATCH
endpoint: channels/{channel_id}
payload: {
    "parent_id": "category_id"
}

Envío de mensajes:

discord_api
method: POST
endpoint: channels/{channel_id}/messages
payload: {
    "content": "Message text with emojis \ud83d\ude04"
}

Asignación de roles:

discord_api
method: PUT
endpoint: guilds/{server_id}/members/{user_id}/roles/{role_id}
payload: {}

La herramienta es compatible con la API de Discord completa, por lo que puedes consultar la documentación de la API de Discord para obtener más puntos de conexión y funciones. Las respuestas incluyen ID y otros metadatos que puedes usar en solicitudes posteriores. Consejos profesionales:

Guardar los ID devueltos de las solicitudes de creación para utilizarlos en solicitudes de seguimiento
¿Se pueden incluir emojis Unicode directamente en el contenido del mensaje? ¿Indicar al modelo que use emojis de Discord como :champagne_glass:? ¿Los mensajes con emojis Unicode bloquean Claude Desktop?
Tipos de canal: 0 = texto, 2 = voz, 4 = categoría, 13 = escenario
Los colores de los roles están en formato decimal (no hexadecimal)
La mayoría de los puntos finales de modificación utilizan el método PATCH
Las cargas útiles vacías deben ser {} y no nulas"

Licencia

Licencia MIT

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

discord_api

Permite la interacción directa con la API de Discord mediante llamadas a la API REST y sintaxis de comando slash para la administración de bots, la configuración del servidor y las operaciones de mensajes.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Discord MCP Server
v-3
-
security
F
license
-
quality
Enables LLMs to interact with Discord channels by sending and reading messages through Discord's API, with a focus on maintaining user control and security.
Last updated -
33
TypeScript
MCP Relay Server
emiliobool
-
security
F
license
-
quality
This server allows integration with Discord, enabling message exchanges between Claude and a Discord channel using prompts and notifications.
Last updated -
TypeScript
discord-mcp
SaseQ
-
security
A
license
-
quality
A Model Context Protocol (MCP) server for the Discord integration with MCP-compatible applications like Claude Desktop.
Last updated -
22
MIT License
MCP-Discord
barryyip0625
A
security
A
license
A
quality
A Discord Model Context Protocol server that enables AI assistants to interact with Discord, providing functionality for sending messages, managing channels, handling forum posts, and working with reactions.
Last updated -
15
19
TypeScript
MIT License

View all related MCP servers

Discord Raw API MCP Server