SaseQ/discord-mcp

</a>
<a href="https://discord.gg/5Uvxe5jteM" target="_blank" style="margin: 2px;">
    
</a>
<a href="https://github.com/SaseQ/discord-mcp/blob/main/LICENSE" target="_blank" style="margin: 2px;">
    
</a>

Discord API için Model Context Protocol (MCP) sunucusu (JDA) kullanılarak oluşturulmuştur. MCP uyumlu uygulamalar (Claude, ChatGPT vb.) ile Discord botlarını entegre etmek için tasarlanmıştır. AI asistanlarının Discord ile etkileşime girmesini sağlayarak kanalları yönetme, mesaj gönderme ve sunucu bilgilerini alma imkanı verir. Güçlü Discord otomasyonu ve AI odaklı iş akışları oluşturmak için idealdir.

🔬 Kurulum

► 🐳 Docker Kurulumu (Önerilen)

[!NOTE] Docker kurulumu gereklidir. Tam talimatlar docker.com üzerinde bulunabilir.

1) Yerel ortam değişkenlerini ayarlayın

export DISCORD_TOKEN="YOUR_DISCORD_BOT_TOKEN"
export DISCORD_GUILD_ID="OPTIONAL_DEFAULT_SERVER_ID"
export SPRING_PROFILES_ACTIVE=http

[!IMPORTANT] Discord bot oluşturma ve token alma talimatları burada bulunabilir.

[!TIP] DISCORD_GUILD_ID ortam değişkeni isteğe bağlıdır.

Sağlandığında, varsayılan bir Discord sunucu ID'si ayarlar, böylece guildId parametresini kabul eden herhangi bir araç bunu atlayabilir.

2) Docker konteynerini çalıştırın

docker run -d -i \
  --name discord-mcp \
  --restart unless-stopped \
  -p 8085:8085 \
  -e SPRING_PROFILES_ACTIVE \
  -e DISCORD_TOKEN \
  -e DISCORD_GUILD_ID \
  saseq/discord-mcp:latest

Varsayılan MCP endpoint URL'si (HTTP profili): http://localhost:8085/mcp

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

cd discord-mcp

cat > .env <<EOF
SPRING_PROFILES_ACTIVE=http
DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>
DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>
EOF

docker compose up -d --build

docker ps --filter name=discord-mcp
curl -fsS http://localhost:8085/actuator/health

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

cd discord-mcp
mvn clean package # JAR dosyası /target dizininde kullanılabilir olacak

DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN> \
DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID> \
SPRING_PROFILES_ACTIVE=http \
java -jar /absolute/path/to/discord-mcp-1.0.0.jar

🔗 Bağlantılar

► 🗞️ Varsayılan config.json Bağlantısı

Önerilen (HTTP singleton modu):

{
  "mcpServers": {
    "discord-mcp": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

Eski mod (stdio, her istemci oturumu için yeni bir işlem/konteyner başlatır):

{
  "mcpServers": {
    "discord-mcp": {
      "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"
      ]
    }
  }
}

claude mcp add discord-mcp --transport http http://localhost:8085/mcp

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

codex mcp add discord-mcp --url http://localhost:8085/mcp
codex mcp list

openclaw mcp set discord-mcp '{"url":"http://localhost:8085/mcp","transport":"streamable-http"}'
openclaw mcp list

{
  "mcp": {
    "servers": {
      "discord-mcp": {
        "url": "http://localhost:8085/mcp",
        "transport": "streamable-http"
      }
    }
  }
}

{
  "mcpServers": {
    "discord-mcp": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

{
  "mcpServers": {
    "discord-mcp": {
      "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"
      ]
    }
  }
}

🛠️ Mevcut Araçlar

Sunucu Bilgileri

• get_server_info: Discord sunucusu hakkında ayrıntılı bilgi alın

Kullanıcı Yönetimi

• get_user_id_by_name: Ping kullanımı için guild içinde username ile Discord kullanıcısının ID'sini alın <@id>
• send_private_message: Belirli bir kullanıcıya özel mesaj gönderin
• edit_private_message: Belirli bir kullanıcıdan özel mesajı düzenleyin
• delete_private_message: Belirli bir kullanıcıdan özel mesajı silin
• read_private_messages: Belirli bir kullanıcının özel mesaj geçmişini okuyun (ek meta verileri içerir, count 1-100 ve isteğe bağlı cursor'u destekler: before veya after veya around)

Mesaj Yönetimi

• send_message: Belirli bir kanala mesaj gönderin
• edit_message: Belirli bir kanaldan mesajı düzenleyin
• delete_message: Belirli bir kanaldan mesajı silin
• read_messages: Belirli bir kanalın mesaj geçmişini okuyun (ek meta verileri içerir, count 1-100 ve isteğe bağlı cursor'u destekler: before veya after veya around)
• add_reaction: Belirli bir mesaja tepki (emoji) ekleyin
• remove_reaction: Bir mesajdan belirtilen tepkiyi (emoji) kaldırın

Kanal Yönetimi

• create_text_channel: Yeni bir metin kanalı oluşturun
• edit_text_channel: Metin kanalı ayarlarını düzenleyin (ad, konu, nsfw, slowmode, kategori, konum)
• delete_channel: Kanalı silin
• find_channel: Ad ve sunucu ID'sini kullanarak kanal türünü ve ID'sini bulun
• list_channels: Tüm kanalların listesi
• get_channel_info: Kanal hakkında ayrıntılı bilgi alın
• move_channel: Kanalı başka bir kategoriye taşıyın ve/veya konumunu değiştirin

Kategori Yönetimi

• create_category: Kanallar için yeni bir kategori oluşturun
• edit_category: Kategorisi düzenleyin (yeniden adlandırın veya konumunu taşıyın)
• delete_category: Kategoriyi silin
• find_category: Ad ve sunucu ID'sini kullanarak kategori ID'sini bulun
• list_channels_in_category: Belirli bir kategorideki kanalların listesi

Webhook Yönetimi

• create_webhook: Belirli bir kanal üzerinde yeni bir webhook oluşturun
• delete_webhook: Webhook'u silin
• list_webhooks: Belirli bir kanal üzerindeki webhook'ların listesi
• send_webhook_message: Webhook aracılığıyla mesaj gönderin

Rol Yönetimi

• list_roles: Sunucudaki tüm rollerin listesini detaylarıyla alın
• create_role: Sunucuda yeni bir rol oluşturun
• edit_role: Mevcut bir rolün ayarlarını değiştirin
• delete_role: Bir rolü sunucudan kalıcı olarak silin
• assign_role: Bir kullanıcıya rol atayın
• remove_role: Bir kullanıcıdan rolü kaldırın

Moderasyon ve Kullanıcı Yönetimi

• kick_member: Üyeyi sunucudan çıkarın
• ban_member: Kullanıcıyı sunucudan yasaklayın
• unban_member: Bir kullanıcının yasağını kaldırın
• timeout_member: Bir üyenin iletişimini belirli bir süre için devre dışı bırakın
• remove_timeout: Süresi dolmadan bir üyenin timeout'unu (sustur) kaldırın
• set_nickname: Sunucudaki bir üyenin takma adını değiştirin
• get_bans: Sunucudaki yasaklı kullanıcıların listesini yasak nedenleriyle döndürün

Ses ve Sahne Kanalı Yönetimi

• create_voice_channel: Guild'de yeni bir ses kanalı oluşturun
• create_stage_channel: Ses etkinlikleri için yeni bir sahne kanalı oluşturun
• edit_voice_channel: Ses veya sahne kanalı ayarlarını düzenleyin (ad, bitrate, kullanıcı limiti, bölge)
• move_member: Üyeyi başka bir ses kanalına taşıyın
• disconnect_member: Üyeyi mevcut ses kanalından ayırın
• modify_voice_state: Ses kanallarında üyeyi sunucu sesi kısma veya kapatma

Planlanan Etkinlik Yönetimi

• create_guild_scheduled_event: Sunucuda yeni bir etkinlik planlayın (ses, sahne veya harici)
• edit_guild_scheduled_event: Etkinlik ayrıntılarını değiştirin veya durumunu değiştirin (başlat, tamamla, iptal)
• delete_guild_scheduled_event: Planlanan etkinliği kalıcı olarak silin
• list_guild_scheduled_events: Sunucudaki tüm etkin ve planlanan etkinlikleri listeleyin
• get_guild_scheduled_event_users: Planlanan etkinliğe ilgi duyan kullanıcıların listesini alın

Kanal İzin Geçişleri

• list_channel_permission_overwrites: Bir kanalın tüm izin geçişlerini rol/üye ayrımına göre listeleyin
• upsert_role_channel_permissions: Bir kanal üzerinde bir rol için izin geçişi oluşturun veya güncelleyin
• upsert_member_channel_permissions: Bir kanal üzerinde bir üye için izin geçişi oluşturun veya güncelleyin
• delete_channel_permission_overwrite: Bir kanal üzerinden bir rol veya üye için izin geçişini silin

Davet Yönetimi

• create_invite: Belirli bir kanal için yeni bir davet linki oluşturun
• list_invites: Sunucudaki tüm aktif davetleri istatistikleriyle listeleyin
• delete_invite: Daveti sil (iptal) ve linkin çalışmasını durdurun
• get_invite_details: Belirli bir daveti hakkında ayrıntı alın (herhangi bir halka açık davet için çalışır)

Forum Yönetimi

• create_forum_channel: Yeni bir forum kanalı oluşturun
• edit_forum_channel: Forum kanalı ayarlarını düzenleyin (ad, konu, nsfw, slowmode, kategori, konum, varsayılan sıralama, varsayılan düzen)
• list_forum_channels: Sunucudaki tüm forum kanallarını listeleyin
• get_forum_channel_info: Etiketler ve ayarlar dahil olmak üzere forum kanalı hakkında ayrıntılı bilgi alın
• list_forum_tags: Forum kanalında kullanılabilir tüm etiketleri listeleyin
• create_forum_post: Forum kanalında ilk mesajla yeni bir forum gönderisi (thread) oluşturun
• list_forum_posts: Forum kanalında etkin gönderileri (thread'leri) listeleyin
• modify_forum_post: Forum gönderisini değiştirin: kilitle/kilidi aç, arşivle/arşivden çıkar, sabitle/sabitlemeyi kaldır veya uygulanan etiketleri değiştirin

Emoji Yönetimi

• list_emojis: Sunucudaki tüm özel emoji'leri listeleyin
• get_emoji_details: Belirli bir özel emoji hakkında ayrıntılı bilgi alın
• create_emoji: Sunucuya yeni bir özel emoji yükleyin (base64 veya resim URL'si, maksimum 256KB)
• edit_emoji: Mevcut bir emoji'nin adını veya rol kısıtlamalarını düzenleyin
• delete_emoji: Özel bir emoji'yi sunucudan kalıcı olarak silin

DISCORD_GUILD_ID ayarlanırsa, guildId parametresi yukarıdaki tüm araçlar için isteğe bağlı olur.

Daha ayrıntılı örnekler Wiki üzerinde bulunabilir.