Discord Admin MCP Server

Сервер Model Context Protocol (MCP), предоставляющий структурированные инструменты для администрирования Discord-серверов, управления ролями, модерации участников и операций с каналами.

Разработан для бесшовной работы с Hermes Agent и любым MCP-совместимым клиентом.

Возможности и инструменты

• Информация о сервере:

  • get_current_bot_user: Просмотр идентичности бота и данных пользователя.

  • list_guilds: Список серверов, в которых состоит бот.

  • get_guild_info: Получение количества участников, ID владельца и настроек сервера.

• Управление ролями:

  • list_roles: Список ролей сервера, их позиций и битовых полей прав.

  • assign_role: Назначение ролей участникам.

  • remove_role: Снятие ролей с участников.

  • create_role: Создание новых ролей с собственными цветами и правами.

  • delete_role: Удаление ролей с сервера.

• Модерация участников:

  • kick_member: Исключение участников с указанием причины в журнале аудита.

  • ban_member: Блокировка участников с возможностью очистки сообщений за период.

  • unban_member: Снятие блокировки с участников.

  • timeout_member: Тайм-аут (заглушение/карантин) для участников на заданное время.

• Управление каналами:

  • list_channels: Список текстовых, голосовых, форумных и анонс-каналов.

  • create_channel: Создание каналов с собственными категориями/темами.

  • edit_channel: Изменение названия канала, статуса NSFW или темы.

  • delete_channel: Удаление каналов.

• Администрирование сообщений:

  • purge_messages: Массовое удаление последних сообщений.

Related MCP server: Discord MCP Server

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

1. Требования

• Python >= 3.10

• Токен Discord-бота с правами модерации сервера и привилегированными Gateway Intents (Server Members Intent).

2. Локальная установка

pip install -e .

3. Конфигурация окружения

Задайте следующие переменные окружения (или добавьте их в .env / ~/.hermes/.env):

DISCORD_BOT_TOKEN=your_bot_token_here
DISCORD_DEFAULT_GUILD_ID=your_server_id_here  # Optional fallback

Интеграция с Hermes Agent

Добавьте в ~/.hermes/config.yaml:

mcp_servers:
  discord_admin:
    command: "/home/kernel/hermes-venv/bin/python3"
    args: ["-m", "discord_admin_mcp.server"]
    env:
      DISCORD_BOT_TOKEN: "your_bot_token_here"

Лицензия

MIT License - Автор: CommanderBiz