Skip to main content
Glama
deenesjakoruzh
alive2

Nika

by alive2
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Nika — Discord-MCP-Server

Ein umfassender Model Context Protocol-Server, der es KI-Assistenten ermöglicht, eine Discord-Community zu verwalten: Nachrichten, Moderation, Rollen, Kanäle, Foren, Webhooks, Einladungen, geplante Events, AutoMod, Onboarding, Emojis/Sticker, Berechtigungsüberschreibungen, Sprachverwaltung — 111 Tools, plus einen rohen REST-Durchgriff (discord_api_request), sodass alles, was die Discord-API kann, erreichbar ist.

Erstellt mit Python + discord.py (persistente Gateway-Verbindung) und FastMCP.

Einrichtung

1. Discord-Bot erstellen (erledigt)

  • Anwendung: Nika (ID 1538805149865091092)

  • Aktivierte Intents: Server Members, Message Content

  • Token: in .env gespeichert (niemals committen — .gitignore schützt ihn)

2. Den Bot zu deinem Server einladen

Öffne diese URL und wähle deinen Server (vergib Administrator für den vollen Funktionsumfang):

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

⚠️ Der Bot muss auf einem Server sein, bevor die meisten Tools etwas tun können.

3. Installieren und konfigurieren

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

.env (bereits erstellt):

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

Verwendung

stdio (Standard — Claude Desktop, VS Code, Cursor usw.)

.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) — Fernzugriff, n8n, Multi-Client

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

Client-Konfiguration:

{
  "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

Testen mit dem MCP Inspector

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

Tool-Referenz (111 Tools)

Bereich

Tools

Server

list_servers, get_server_info, get_server_summary, modify_server, leave_server

Kanäle

list_channels, list_categories, find_channel, get_channel_info, create_text_channel, create_voice_channel, create_stage_channel, create_category, create_forum_channel, edit_channel, move_channel, clone_channel, delete_channel, create_thread, list_active_threads, list_channel_threads

Nachrichten

send_message (Embeds + Dateien + Antwort), reply_to_message, edit_message, delete_message, bulk_delete_messages, read_messages (vor/nach/um), get_message, pin_message, unpin_message, list_pinned_messages, add_reaction, add_multiple_reactions, remove_reaction, clear_reactions

Mitglieder

get_member_info, find_user (nach Name/Nick → Ping), list_members, set_nickname, get_user_by_id

Rollen

list_roles, create_role, edit_role, delete_role, assign_role, remove_role, get_user_roles

DMs

send_private_message, edit_private_message, delete_private_message, read_private_messages

Moderation

kick_member, ban_member, unban_member, get_bans, timeout_member, remove_timeout, prune_members (Dry-Run-sicher)

Voice

move_member, disconnect_member, modify_voice_state (mute/deafen/suppress), get_voice_channel_members, list_voice_channels

Events

create_scheduled_event, edit_scheduled_event, delete_scheduled_event, list_scheduled_events, get_scheduled_event, get_scheduled_event_users

Berechtigungen

list_channel_permission_overwrites, upsert_role_channel_permissions, upsert_member_channel_permissions, delete_channel_permission_overwrite

Einladungen

create_invite, list_invites, delete_invite, get_invite_details

Webhooks

create_webhook, edit_webhook, delete_webhook, list_webhooks, send_webhook_message

Foren

list_forum_channels, get_forum_channel_info, list_forum_tags, add_forum_tag, edit_forum_tag, delete_forum_tag, create_forum_post, reply_to_forum_post, list_forum_posts, modify_forum_post, delete_forum_post

Emojis & Sticker

list_emojis, get_emoji_details, create_emoji, edit_emoji, delete_emoji, list_stickers, create_sticker, edit_sticker, delete_sticker

AutoMod

list_automod_rules, create_automod_rule (Schlüsselwörter/Regex/Voreinstellungen/Erwähnungs-Spam), edit_automod_rule, delete_automod_rule

Onboarding & Audit

get_welcome_screen, modify_welcome_screen, get_onboarding, search_audit_log

Raw API

discord_api_request — beliebiger Endpunkt, beliebige Methode (PUT/PATCH/DELETE benötigen confirmDestructive=true), respektiert Rate-Limits

Design-Notizen

  • Hybrides Gateway + REST: Eine persistente discord.py-Gateway-Verbindung liefert Live-Zustand (Mitglieds-/Kanal-Lookups, Namen→IDs), während Mutationen über denselben Client laufen. Toolaufrufe werden über asyncio.run_coroutine_threadsafe auf die Gateway-Schleife gebrückt.

  • Sicherheit: Das Raw-Tool erfordert confirmDestructive=true für mutierende Methoden; prune_members standardmäßig als Trockenlauf; destruktive Tools akzeptieren einen reason, der im Audit-Log festgehalten wird.

  • Optionaler guildId: Setze DISCORD_GUILD_ID in .env und jeder guildId-Parameter wird optional.

  • Fehler: Discord-Fehler werden in lesbare Meldungen umgewandelt (z. B. Missing permissions: ...).

Einschränkungen

  • Erfordert einen Bot-Token (User-Token-/Self-Bot-Automatisierung verstößt gegen die Discord-ToS).

  • Zum Lesen von Nachrichten muss der Bot den Kanal sehen und (für Inhalte) den Message Content intent besitzen.

  • Kein Sprach-Audio-Streaming/-Empfang.

Entwicklung

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

Layout: discord_mcp/bot.py (Gateway-Brücke) · discord_mcp/server.py (FastMCP) · discord_mcp/tools/*.py (ein Modul pro Domäne) · discord_mcp/utils/ (Serializer, Embeds).

Lizenz

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP-Discord

    jar285
    A
    license
    B
    quality
    D
    maintenance
    A Discord MCP server that enables AI assistants to interact with Discord platforms, providing functionalities like sending messages, managing channels, creating forum posts, and handling webhooks.
    21
    768 npm
    1
    MIT

  • Cloud Discord

    codependentai
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that gives AI agents full admin control over Discord servers with 59 tools for messaging, moderation, roles, channels, forums, reactions, files, and more, deployed on Cloudflare Workers.
    4
    MIT

  • discord-mcp

    jonasgantner
    A
    license
    Not graded
    quality
    D
    maintenance
    Comprehensive Discord MCP server with 66 tools that provides rich message context including emoji reactions, thread indicators, and attachment metadata inline. Enables AI assistants to interact with Discord servers for messaging, moderation, roles, channels, and more.
    184 npm
    1
    MIT

  • mcp-discord

    danushkumar-v
    A
    license
    B
    quality
    D
    maintenance
    A Discord MCP server that enables AI assistants to interact with the Discord platform, providing features like message sending, channel management, forum operations, reactions, and webhook management.
    22
    768 npm
    MIT