Discord Mcp

¿Qué es Discord-MCP?

Discord-MCP es un servidor potente diseñado para integrarse con Discord, permitiendo una interacción fluida entre asistentes de IA y la plataforma de Discord. Esta herramienta mejora la experiencia del usuario al automatizar diversas tareas y proporcionar funcionalidades avanzadas que optimizan la comunicación y el compromiso dentro de las comunidades de Discord.

Características de Discord-MCP

• Integración de IA: Permite que los asistentes de IA interactúen directamente con Discord, proporcionando respuestas y asistencia en tiempo real.
• Capacidades de Automatización: Automatiza tareas repetitivas, facilitando a los usuarios la gestión de sus servidores de Discord.
• Interfaz Amigable: Diseñada con la simplicidad en mente, lo que la hace accesible para usuarios de todos los niveles de habilidad.
• Código Abierto: Al ser un repositorio público, los usuarios pueden contribuir a su desarrollo y personalizarlo para adaptarlo a sus necesidades.
• Soporte Comunitario: Una comunidad en crecimiento de usuarios y desarrolladores que comparten consejos, trucos y apoyo para usar Discord-MCP de manera efectiva.

Cómo Usar Discord-MCP

1. Instalación: Clona el repositorio desde GitHub y sigue las instrucciones de instalación proporcionadas en el archivo README.
2. Configuración: Configura tu bot de Discord y establece los permisos necesarios para permitirle interactuar con tu servidor.
3. Integración: Conecta tu asistente de IA a Discord-MCP, habilitándolo para responder a comandos y mensajes.
4. Personalización: Modifica el código según sea necesario para adaptar las funcionalidades a tus requisitos específicos.
5. Compromiso: Comienza a usar tu asistente de IA en Discord, mejorando las interacciones y automatizando tareas para una experiencia más fluida.

Preguntas Frecuentes

P: ¿Es Discord-MCP gratuito?

R: Sí, Discord-MCP es un proyecto de código abierto y es gratuito para usar.

P: ¿Puedo contribuir al proyecto?

R: ¡Absolutamente! Las contribuciones son bienvenidas. Puedes bifurcar el repositorio, hacer cambios y enviar una solicitud de extracción.

P: ¿Qué lenguajes de programación se utilizan en Discord-MCP?

R: Discord-MCP está construido principalmente con JavaScript y Node.js.

P: ¿Cómo reporto problemas o errores?

R: Puedes reportar problemas creando un nuevo issue en el repositorio de GitHub en la pestaña "Issues".

P: ¿Dónde puedo encontrar documentación para Discord-MCP?

R: La documentación está disponible en el archivo README del repositorio y a través de foros y discusiones comunitarias.

Al utilizar Discord-MCP, los usuarios pueden mejorar significativamente su experiencia en Discord, haciendo que las interacciones sean más eficientes y agradables.

<div align="center"> <img src="assets/img/Discord_MCP_full_logo.svg" width="60%" alt="DeepSeek-V3" /> </div> <hr> <div align="center" style="line-height: 1;"> <a href="https://github.com/modelcontextprotocol/servers" target="_blank" style="margin: 2px;"> <img alt="MCP Server" src="https://badge.mcpx.dev?type=server" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://smithery.ai/server/@SaseQ/discord-mcp" target="_blank" style="margin: 2px;"> <img alt="Smithery Badge" src="https://camo.githubusercontent.com/ee5c6c6dc502821f4d57313b2885f7878af52be14142dd98526ea12aedf9b260/68747470733a2f2f736d6974686572792e61692f62616467652f40646d6f6e74676f6d65727934302f646565707365656b2d6d63702d736572766572" data-canonical-src="https://smithery.ai/server/@SaseQ/discord-mcp" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://discord.gg/5Uvxe5jteM" target="_blank" style="margin: 2px;"> <img alt="Discord" src="https://img.shields.io/discord/936242526120194108?color=7389D8&label&logo=discord&logoColor=ffffff" style="display: inline-block; vertical-align: middle;"/> </a> <a href="https://github.com/SaseQ/discord-mcp/blob/main/LICENSE" target="_blank" style="margin: 2px;"> <img alt="MIT License" src="https://img.shields.io/github/license/SaseQ/discord-mcp" style="display: inline-block; vertical-align: middle;"/> </a> </div>

📖 Description

A Model Context Protocol (MCP) server for the Discord API (JDA), allowing seamless integration of Discord Bot with MCP-compatible applications like Claude Desktop.

Enable your AI assistants to seamlessly interact with Discord. Manage channels, send messages, and retrieve server information effortlessly. Enhance your Discord experience with powerful automation capabilities.

🔬 Installation

► 🐳 Docker Installation (Recommended)

NOTE: Docker installation is required. Full instructions can be found on docker.com.

{
  "mcpServers": {
    "mcp-server": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

<details> <summary style="font-size: 1.35em; font-weight: bold;"> 🔧 Manual Installation </summary>

Clone the repository

git clone https://github.com/SaseQ/discord-mcp

Build the project

NOTE: Maven installation is required to use the mvn command. Full instructions can be found here.

cd discord-mcp
mvn clean package # The jar file will be available in the /target directory

Configure AI client

Many code editors and other AI clients use a configuration file to manage MCP servers.

The Discord MPC server can be configured by adding the following to your configuration file.

NOTE: You will need to create a Discord Bot token to use this server. Instructions on how to create a Discord Bot token can be found here.

{
  "mcpServers": {
    "discord-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "/absolute/path/to/discord-mcp-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR_DISCORD_BOT_TOKEN",
        "DISCORD_GUILD_ID": "OPTIONAL_DEFAULT_SERVER_ID"
      }
    }
  }
}

The DISCORD_GUILD_ID environment variable is optional. When provided, it sets a default Discord server ID so any tool that accepts a guildId parameter can omit it.

</details> <details> <summary style="font-size: 1.35em; font-weight: bold;"> ⚓ Smithery Installation </summary>

Install Discord MCP Server automatically via Smithery:

npx -y @smithery/cli@latest install @SaseQ/discord-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

</details> <details> <summary style="font-size: 1.35em; font-weight: bold;"> 🖲 Cursor Installation </summary>

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Pasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.

{
  "mcpServers": {
    "mcp-server": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

</details> <details> <summary style="font-size: 1.35em; font-weight: bold;"> ⌨️ Claude Code Installation </summary>

Run this command. See Claude Code MCP docs for more info.

claude mcp add mcp-server -- docker run --rm -i -e DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN> -e DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID> saseq/discord-mcp:latest

</details>

🛠️ Available Tools

Server Information

• get_server_info: Get detailed discord server information

User Management

• get_user_id_by_name: Get a Discord user's ID by username in a guild for ping usage <@id>
• send_private_message: Send a private message to a specific user
• edit_private_message: Edit a private message from a specific user
• delete_private_message: Delete a private message from a specific user
• read_private_messages: Read recent message history from a specific user

Message Management

• send_message: Send a message to a specific channel
• edit_message: Edit a message from a specific channel
• delete_message: Delete a message from a specific channel
• read_messages: Read recent message history from a specific channel
• add_reaction: Add a reaction (emoji) to a specific message
• remove_reaction: Remove a specified reaction (emoji) from a message

Channel Management

• create_text_channel: Create text a channel
• delete_channel: Delete a channel
• find_channel: Find a channel type and ID using name and server ID
• list_channels: List of all channels

Category Management

• create_category: Create a new category for channels
• delete_category: Delete a category
• find_category: Find a category ID using name and server ID
• list_channels_in_category: List of channels in a specific category

Webhook Management

• create_webhook: Create a new webhook on a specific channel
• delete_webhook: Delete a webhook
• list_webhooks: List of webhooks on a specific channel
• send_webhook_message: Send a message via webhook

If DISCORD_GUILD_ID is set, the guildId parameter becomes optional for all tools above.

<hr>

A more detailed examples can be found in the Wiki.