Nika — Discord MCP Server

Комплексный сервер Model Context Protocol, который позволяет ИИ-ассистентам управлять Discord-сообществом: обмен сообщениями, модерация, роли, каналы, форумы, вебхуки, приглашения, запланированные события, AutoMod, онбординг, эмодзи/стикеры, переопределения прав, управление голосовыми каналами — 111 инструментов, плюс прямой REST-доступ (discord_api_request), так что всё, что умеет Discord API, доступно.

Создан на Python + discord.py (постоянное gateway-подключение) и FastMCP.

Настройка

1. Создание Discord-бота (готово)

• Приложение: Nika (ID 1538805149865091092)

• Включённые интенты: Server Members, Message Content

• Токен: хранится в .env (никогда не коммитьте его — .gitignore защищает его)

2. Пригласите бота на свой сервер

Откройте этот URL и выберите сервер (выдайте права Администратор для полной функциональности):

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

⚠️ Бот должен находиться на сервере, прежде чем большинство инструментов смогут что-либо сделать.

3. Установка и настройка

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

.env (уже создан):

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

Использование

stdio (по умолчанию — Claude Desktop, VS Code, Cursor и т.д.)

.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) — удалённый доступ, n8n, несколько клиентов

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

Конфигурация клиента:

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

Тестирование с помощью MCP Inspector

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

Справочник инструментов (111 инструментов)

Заметки по архитектуре

• Гибридный gateway + REST: одно постоянное gateway-подключение discord.py предоставляет актуальное состояние (поиск участников/каналов, имена→ID), в то время как изменения проходят через того же клиента. Вызовы инструментов переносятся в цикл gateway через asyncio.run_coroutine_threadsafe.

• Безопасность: прямой инструмент требует confirmDestructive=true для изменяющих методов; prune_members по умолчанию работает в режиме пробного запуска; разрушительные инструменты принимают reason, который записывается в журнал аудита.

• Необязательный guildId: установите DISCORD_GUILD_ID в .env, и каждый параметр guildId станет необязательным.

• Ошибки: ошибки Discord преобразуются в понятные сообщения (например, Missing permissions: ...).

Ограничения

• Требуется токен бота (автоматизация через пользовательский токен/self-bot нарушает условия использования Discord).

• Для чтения сообщений боту нужен доступ к каналу и (для содержимого) интент Message Content.

• Нет потоковой передачи/приёма голосового аудио.

Разработка

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

Структура: discord_mcp/bot.py (gateway-мост) · discord_mcp/server.py (FastMCP) · discord_mcp/tools/*.py (один модуль на домен) · discord_mcp/utils/ (сериализаторы, эмбеды).

Лицензия

MIT