Discord Mcp
Un server MCP per l'integrazione con Discord. Abilita i tuoi assistenti AI a interagire senza problemi con Discord. Migliora la tua esperienza su Discord con potenti capacità di automazione.
Panoramica
Cos'è Discord-MCP?
Discord-MCP è un potente server progettato per integrarsi con Discord, consentendo un'interazione fluida tra assistenti AI e la piattaforma Discord. Questo strumento migliora l'esperienza dell'utente automatizzando vari compiti e fornendo funzionalità avanzate che semplificano la comunicazione e l'impegno all'interno delle comunità di Discord.
Caratteristiche di Discord-MCP
- Integrazione AI: Consente agli assistenti AI di interagire direttamente con Discord, fornendo risposte e assistenza in tempo reale.
- Capacità di Automazione: Automatizza compiti ripetitivi, rendendo più facile per gli utenti gestire i propri server Discord.
- Interfaccia Intuitiva: Progettata con semplicità in mente, rendendola accessibile per utenti di tutti i livelli di abilità.
- Open Source: Essendo un repository pubblico, gli utenti possono contribuire al suo sviluppo e personalizzarlo per soddisfare le proprie esigenze.
- Supporto della Comunità: Una comunità in crescita di utenti e sviluppatori che condividono suggerimenti, trucchi e supporto per utilizzare Discord-MCP in modo efficace.
Come Utilizzare Discord-MCP
- Installazione: Clona il repository da GitHub e segui le istruzioni di installazione fornite nel file README.
- Configurazione: Imposta il tuo bot Discord e configura i permessi necessari per consentirgli di interagire con il tuo server.
- Integrazione: Collega il tuo assistente AI a Discord-MCP, consentendogli di rispondere a comandi e messaggi.
- Personalizzazione: Modifica il codice secondo necessità per adattare le funzionalità alle tue specifiche esigenze.
- Coinvolgimento: Inizia a utilizzare il tuo assistente AI in Discord, migliorando le interazioni e automatizzando compiti per un'esperienza più fluida.
Domande Frequenti
D: Discord-MCP è gratuito da usare?
R: Sì, Discord-MCP è un progetto open-source ed è gratuito da utilizzare.
D: Posso contribuire al progetto?
R: Assolutamente! I contributi sono benvenuti. Puoi forkare il repository, apportare modifiche e inviare una pull request.
D: Quali linguaggi di programmazione sono utilizzati in Discord-MCP?
R: Discord-MCP è principalmente costruito utilizzando JavaScript e Node.js.
D: Come posso segnalare problemi o bug?
R: Puoi segnalare problemi creando un nuovo problema nel repository GitHub sotto la scheda "Issues".
D: Dove posso trovare la documentazione per Discord-MCP?
R: La documentazione è disponibile nel file README del repository e attraverso forum e discussioni della comunità.
Utilizzando Discord-MCP, gli utenti possono migliorare significativamente la propria esperienza su Discord, rendendo le interazioni più efficienti e piacevoli.
Dettaglio
📖 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.
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 useredit_private_message
: Edit a private message from a specific userdelete_private_message
: Delete a private message from a specific userread_private_messages
: Read recent message history from a specific user
Message Management
send_message
: Send a message to a specific channeledit_message
: Edit a message from a specific channeldelete_message
: Delete a message from a specific channelread_messages
: Read recent message history from a specific channeladd_reaction
: Add a reaction (emoji) to a specific messageremove_reaction
: Remove a specified reaction (emoji) from a message
Channel Management
create_text_channel
: Create text a channeldelete_channel
: Delete a channelfind_channel
: Find a channel type and ID using name and server IDlist_channels
: List of all channels
Category Management
create_category
: Create a new category for channelsdelete_category
: Delete a categoryfind_category
: Find a category ID using name and server IDlist_channels_in_category
: List of channels in a specific category
Webhook Management
create_webhook
: Create a new webhook on a specific channeldelete_webhook
: Delete a webhooklist_webhooks
: List of webhooks on a specific channelsend_webhook_message
: Send a message via webhook
<hr>If
DISCORD_GUILD_ID
is set, theguildId
parameter becomes optional for all tools above.
A more detailed examples can be found in the Wiki.
Configurazione Server
{
"mcpServers": {
"discord-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--saseq--discord-mcp--discord-mcp",
"java -Dserver.port=$PORT $JAVA_OPTS -jar target/*jar"
],
"env": {
"DISCORD_TOKEN": "discord-token"
}
}
}
}