MCP-Discord

Сервер Discord MCP (Model Context Protocol), который позволяет ИИ-ассистентам взаимодействовать с платформой Discord.

Обзор

MCP-Discord предоставляет следующие функции для работы с Discord:

• Вход в систему через бота Discord

• Список серверов, на которых состоит бот

• Получение информации о сервере

• Список участников и просмотр подробной информации об участниках

• Список, создание, редактирование, удаление, назначение и удаление ролей

• Поиск сообщений на сервере

• Чтение, редактирование и удаление сообщений в каналах

• Отправка сообщений в указанные каналы

• Получение списков каналов форумов

• Создание, обновление, удаление и ответы на публикации на форумах

• Список тем форума и управление тегами форума

• Создание, редактирование и удаление текстовых, форумных, голосовых каналов и категорий

• Установка и удаление переопределений прав доступа к каналам

• Добавление/удаление реакций на сообщения

• Создание/редактирование/удаление/использование вебхуков

Related MCP server: MCP-Discord

Содержание

• Предварительные требования

• Установка

• Конфигурация

• Документация по инструментам

  • Основные функции

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

  • Функции форума

  • Сообщения и реакции

  • Управление вебхуками

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

  • Управление участниками

• Разработка

• Лицензия

Предварительные требования

• Node.js (v18.0.0 или выше)

• npm (v7.0.0 или выше)

• Бот Discord с соответствующими правами доступа

  • Токен бота (можно получить на Портале разработчиков Discord)

  • Включенный Message Content Intent

  • Включенный Server Members Intent

  • Включенный Presence Intent

• Права доступа, необходимые на вашем сервере Discord:

  Простейшая настройка

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

  Или выберите только необходимые права:

  • Отправка сообщений

  • Создание публичных тем

  • Отправка сообщений в темах

  • Управление сообщениями

  • Управление темами

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

  • Управление вебхуками

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

  • Добавление реакций

  • Просмотр канала

• Добавьте своего бота Discord на сервер

  • Чтобы добавить бота Discord на свой сервер, используйте одну из следующих ссылок-приглашений (замените INSERT_CLIENT_ID_HERE на ID клиента вашего бота):

    • Администратор (полный доступ): https://discord.com/oauth2/authorize?client\\\\_id=INSERT\\\\_CLIENT\\\\_ID\\\\_HERE\\\\&scope=bot\\\\&permissions=8

    • Пользовательские права (минимально необходимые): https://discord.com/oauth2/authorize?client\\\\_id=INSERT\\\\_CLIENT\\\\_ID\\\\_HERE\\\\&scope=bot\\\\&permissions=52076489808

Примечание:
Согласно модели безопасности Discord, бот может получать доступ к информации только с тех серверов, на которые он был явно добавлен.
Если вы хотите использовать этот MCP-сервер для доступа к определенному серверу Discord, вы должны сначала добавить бота на этот сервер.
Используйте ссылку-приглашение ниже, чтобы добавить бота на целевой сервер.

Установка

Установка через NPM

Вы можете использовать его с помощью следующей команды:

npx mcp-discord --config ${DISCORD_TOKEN}

Для получения дополнительной информации вы можете ознакомиться с пакетом NPM.

Установка через Smithery

Чтобы установить mcp-discord автоматически через Smithery

Установка через Docker

Вы можете запустить mcp-discord с помощью Docker. Образы Docker автоматически собираются и публикуются в Docker Hub.

Репозиторий Docker Hub: barryy625/mcp-discord

Docker по умолчанию использует потоковый HTTP-сервер через build/app.js.

# Pull the latest image
docker pull barryy625/mcp-discord:latest

# Run HTTP server on port 8080
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 8080:8080 barryy625/mcp-discord:latest

# Override the listening port if needed
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 3000:3000 barryy625/mcp-discord:latest --transport http --port 3000

Доступные теги:

• latest - Последняя стабильная версия из основной ветки

• v1.3.8 и т.д. - Релизы конкретных версий

Ручная установка

# Clone the repository
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord

# Install dependencies
npm install

# Compile TypeScript
npm run build

Конфигурация

Для правильной работы требуется токен бота Discord. Сервер поддерживает два метода передачи: stdio и потоковый HTTP.

Методы передачи

1. stdio (по умолчанию)

   • Традиционная передача stdio для базового использования

   • Подходит для простых интеграций

2. Потоковый HTTP

   • HTTP-передача для более сложных сценариев

   • Поддерживает работу без сохранения состояния

   • Настраиваемый номер порта

Параметры конфигурации

Вы можете предоставить конфигурацию двумя способами:

1. Переменные окружения:

DISCORD_TOKEN=your_discord_bot_token

2. Использование аргументов командной строки:

# For stdio transport (default)
node build/index.js --config "your_discord_bot_token"

# For streamable HTTP transport
node build/app.js --transport http --port 3000 --config "your_discord_bot_token"

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

1. Использование передачи Stdio с Claude/Cursor

Используйте build/index.js, когда ваш MCP-клиент ожидает stdio-сервер на основе команд.

Claude Desktop / Claude Code

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token"
            }
        }
    }
}

Cursor

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token"
            }
        }
    }
}

Это рекомендуемая настройка для локальных MCP-клиентов на основе команд.

2. Самостоятельный хостинг потокового HTTP-сервера

Используйте build/app.js, если вы хотите запустить mcp-discord как HTTP MCP-сервер.

Запуск с Node.js

DISCORD_TOKEN=your_discord_bot_token node build/app.js --transport http --port 3000

В Windows PowerShell:

$env:DISCORD_TOKEN="your_discord_bot_token"
node build/app.js --transport http --port 3000

Запуск с Docker

docker run -e DISCORD_TOKEN=your_discord_bot_token -p 3000:3000 barryy625/mcp-discord:latest --transport http --port 3000

После запуска конечная точка MCP HTTP будет:

http://localhost:3000/mcp

3. Подключение к размещенному HTTP MCP-серверу

Если вы уже разместили mcp-discord где-то еще, укажите своему MCP-клиенту конечную точку /mcp сервера вместо запуска build/app.js в качестве команды.

Пример конечной точки:

https://your-server.example.com/mcp

Важные примечания:

• build/app.js запускает HTTP-сервер. Он не использует stdio.

• build/index.js — это правильная точка входа для MCP-клиентов на основе stdio.

• Для использования размещенного HTTP настройте свой MCP-клиент на подключение к URL-адресу HTTP-конечной точки, предоставленному вашим развертыванием.

• Точный формат конфигурации HTTP-клиента зависит от используемого вами MCP-клиента.

Документация по инструментам

Основные функции

• discord_login: Вход в Discord с использованием настроенного токена

• discord_list_servers: Список всех серверов Discord, на которых состоит бот

• discord_send: Отправка сообщения в указанный канал

• discord_get_server_info: Получение информации о сервере Discord

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

• discord_create_text_channel: Создание текстового канала

• discord_create_forum_channel: Создание канала форума

• discord_create_voice_channel: Создание голосового канала

• discord_edit_channel: Редактирование названия канала, темы, родительской категории или позиции

• discord_delete_channel: Удаление канала

• discord_create_category: Создание категории каналов

• discord_edit_category: Редактирование категории каналов

• discord_delete_category: Удаление категории каналов

• discord_set_channel_permissions: Установка переопределений прав доступа для роли или пользователя в канале/категории

• discord_remove_channel_permissions: Удаление переопределений прав доступа из канала/категории

Функции форума

• discord_get_forum_channels: Получение списка каналов форумов

• discord_create_forum_post: Создание публикации на форуме

• discord_get_forum_post: Получение публикации на форуме

• discord_list_forum_threads: Список активных и архивированных тем в канале форума

• discord_reply_to_forum: Ответ на публикацию на форуме

• discord_get_forum_tags: Получение всех доступных тегов для канала форума

• discord_set_forum_tags: Замена доступных тегов для канала форума

• discord_update_forum_post: Обновление заголовка, тегов, состояния архивации или состояния блокировки публикации на форуме

• discord_delete_forum_post: Удаление публикации на форуме

Сообщения и реакции

• discord_search_messages: Поиск сообщений на сервере

• discord_read_messages: Чтение сообщений канала (поддерживает параметры before, after, around — принимает ID snowflake или даты в формате ISO 8601, например, "2025-03-01T00:00:00Z")

• discord_edit_message: Редактирование сообщения, созданного ботом

• discord_add_reaction: Добавление реакции на сообщение

• discord_add_multiple_reactions: Добавление нескольких реакций на сообщение

• discord_remove_reaction: Удаление реакции с сообщения

• discord_delete_message: Удаление конкретного сообщения из канала

Управление вебхуками

• discord_create_webhook: Создает новый вебхук для канала Discord

• discord_send_webhook_message: Отправляет сообщение в канал Discord с помощью вебхука

• discord_edit_webhook: Редактирует существующий вебхук для канала Discord

• discord_delete_webhook: Удаляет существующий вебхук для канала Discord

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

• discord_list_roles: Список всех ролей на сервере

• discord_create_role: Создание роли с параметрами цвета, отображения, упоминания и прав доступа

• discord_edit_role: Редактирование существующей роли

• discord_delete_role: Удаление роли

• discord_assign_role: Назначение роли участнику

• discord_remove_role: Удаление роли у участника

Управление участниками

• discord_list_members: Список участников на сервере с ролями

• discord_get_member: Получение подробной информации о конкретном участнике

Разработка

# Development mode
npm run dev

Лицензия

Лицензия MIT