@devli13/mcp-discord

MCP-сервер для Discord. Отправляйте сообщения, модерируйте, управляйте каналами, проверяйте серверы — из Claude Code, агентов Paperclip, Gemini CLI или любого другого MCP-совместимого клиента.

Чистая обертка REST. Без Gateway. Без базы данных. Только API Discord v10 в виде 26 хорошо задокументированных инструментов с ограничением частоты запросов (rate limiting) для каждого маршрута и структурированными результатами ошибок.

Зачем

API Discord обширен и неудобен для агентов при вызове через обычный curl. Агенты сталкиваются с ограничениями частоты запросов, неправильно обрабатывают 429 ошибки, путаются в причинах аудита, забывают курсоры пагинации. Этот MCP решает это раз и навсегда, чтобы агенты могли сосредоточиться на намерениях: «удалить то спам-сообщение», «опубликовать ежедневную сводку в #mod-log», «заблокировать @user на час».

Также отлично подходит для людей. Подключившись к Claude Code, вы можете сказать: «сделай краткую сводку последних 50 сообщений в моем Discord-канале #dev», и Claude просто сделает это.

Related MCP server: Discord Bridge MCP Server

Установка

npm install -g @devli13/mcp-discord

Или через npx (без установки):

DISCORD_BOT_TOKEN=<your-token> npx -y @devli13/mcp-discord

Настройка

1. Создайте бота Discord

1. Перейдите на https://discord.com/developers/applications → New Application

2. Добавьте Bot в приложение

3. Скопируйте токен бота — это ваш DISCORD_BOT_TOKEN

4. Пригласите бота на свой сервер, используя генератор URL OAuth2 (область действия: bot). Выберите разрешения в зависимости от того, что должен делать MCP (например, «Управление сообщениями» для удаления, «Модерация участников» для тайм-аутов)

2. Подключите его к вашему MCP-клиенту

Claude Code:

claude mcp add discord \
  --env DISCORD_BOT_TOKEN=<your-token> \
  -- npx -y @devli13/mcp-discord

Paperclip mcp-gateway (.mcp.json):

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@devli13/mcp-discord"],
      "env": {
        "DISCORD_BOT_TOKEN": "<your-token>"
      }
    }
  }
}

Gemini CLI (~/.gemini/config.json):

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "@devli13/mcp-discord"]
    }
  }
}

3. (Опционально) Включите привилегированные интенты

Если вы хотите получать список участников сервера (discord_list_members) или использовать этот MCP вместе с сопутствующим плагином для входящих событий, включите Server Members Intent и Message Content Intent в настройках вашего бота на портале разработчика. Они не требуются для большинства операций MCP — только для определенных конечных точек.

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

Все инструменты имеют префикс discord_* и возвращают либо JSON-блок (в случае успеха), либо отформатированное сообщение об ошибке (в случае неудачи). Ни один из них не вызывает исключений — каждый инструмент возвращает пригодный для использования строковый результат.

Сообщения (8)

Реакции (3)

Каналы и ветки (5)

Модерация (6)

Информация о сервере (4)

Не включено (намеренно):

• ban/unban — намеренно. Используйте интерфейс Discord; необратимые действия не должны выполняться одним вызовом агента

• Создание/удаление/редактирование каналов — высокий риск, используйте интерфейс

• CRUD вебхуков — не требуется для большинства сценариев агентов; можно добавить в будущем релизе

• Голосовые операции, управление стикерами/эмодзи — вне области действия v0.1

Пример: краткая сводка канала через Claude Code

User: Summarize the last 30 messages in the #dev channel of my Discord server, guild ID 1234...

Claude (calls discord_list_channels → finds #dev → calls discord_list_messages → writes summary)

Пример: ежедневная сводка агента Paperclip

// From an agent's prompt:
"Post the daily digest to channel 1234. Summarize the last 24h of activity
using discord_list_messages with limit=100, then format as an embed via
discord_send_message."

Обработка ошибок

Каждый инструмент возвращает пригодный для использования текстовый результат. В случае ошибки:

Error (DISCORD_50001, HTTP 403): Missing Access
Details: [...]
(This error is transient and may succeed on retry.)

MCP уже обрабатывает повторные попытки внутри для 429 (ограничения частоты) и 5xx (ошибки сервера) с экспоненциальной задержкой.

Ограничения частоты запросов (Rate limits)

В Discord есть два уровня ограничений:

1. По маршруту — каждая конечная точка API имеет независимые корзины. Этот MCP сериализует запросы по (метод + шаблон маршрута), чтобы предотвратить превышение лимита 429.

2. Глобальный — на бота, по всем конечным точкам. MCP глобально учитывает заголовки Retry-After.

Вам не нужно об этом думать. Если вы постоянно достигаете глобального лимита, вероятно, вы делаете что-то, что требует участия человека.

Безопасность

• Никогда не коммитьте токен вашего бота. Этот MCP считывает его из переменной окружения DISCORD_BOT_TOKEN при запуске.

• Используйте URL-адреса приглашений с минимальными привилегиями. Не давайте ботам права администратора, если вам нужно только «Управление сообщениями».

• Причины в журнале аудита — все инструменты модерации принимают аргумент reason, который отображается в журнале аудита Discord. Используйте его.

Разработка

git clone https://github.com/devli13/mcp-discord.git
cd mcp-discord
npm install
npm test           # smoke tests (no live Discord calls)
npm run lint       # syntax check all files
npm start          # boot server over stdio (needs DISCORD_BOT_TOKEN)

Сопутствующий проект — входящие события

Этот MCP обрабатывает исходящие REST-вызовы (отправка, удаление, модерация). Он не поддерживает WebSocket Discord Gateway, поэтому не может реагировать на входящие события (упоминание бота через @, личные сообщения, вступление новых участников).

Для входящих событий Discord в настройке Paperclip используйте @devli13/paperclip-plugin-discord — форк @mvanhorn/paperclip-plugin-discord с произвольной маршрутизацией @упоминаний, поддержкой личных сообщений, сериализованной очередью сообщений для каждого контекста и заполнением пропущенных упоминаний.

Эти два проекта разработаны для совместной работы: плагин получает события и вызывает вашего агента; агент использует этот MCP для ответа и модерации. Используйте один или оба в зависимости от вашей настройки.

Атрибуция

См. ATTRIBUTION.md. Кратко: создано вместе с форком paperclip-plugin-discord от @mvanhorn, чья обработка Gateway вдохновила использованные здесь паттерны проектирования.

Лицензия

MIT — см. LICENSE.