MCP-Discord

значок кузнеца

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

Обзор

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

Войти в Discord-бот
Получить информацию о сервере
Чтение/удаление сообщений канала
Отправлять сообщения на указанные каналы (используя либо идентификаторы каналов, либо названия каналов)
Получить списки каналов форума
Создание/удаление/ответ на сообщения форума
Создание/удаление текстовых каналов
Добавить/удалить реакции на сообщения
Создание/редактирование/удаление/использование вебхуков

Related MCP server: MCP Toolkit

Предпосылки

Node.js (v16.0.0 или выше)
npm (v7.0.0 или выше)
Бот Discord с соответствующими разрешениями
- Токен бота (можно получить на портале разработчиков Discord )
- Включено намерение содержания сообщения
- Намерение участников сервера включено
- Намерение присутствия включено
Разрешения, необходимые на вашем сервере Discord:

Самая простая настройка

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

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

Отправить сообщения
Создать публичные темы
Отправить сообщения в темах
Управление сообщениями
Управление потоками
Управление каналами
Управление веб-хуками
Добавить реакции
Просмотреть канал
Добавьте своего Discord-бота на свой сервер
- Чтобы добавить бота Discord на свой сервер, используйте одну из следующих ссылок-приглашений (замените INSERT_CLIENT_ID_HERE на идентификатор клиента вашего бота):
  - Администратор (полный доступ): 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, вам необходимо сначала добавить бота на этот сервер.
Используйте ссылку-приглашение ниже, чтобы добавить бота на целевой сервер.

Установка

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

Для автоматической установки mcp-discord через Smithery

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

# 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 и streamable HTTP.

Методы транспортировки

stdio (по умолчанию)
- Традиционный stdio-транспорт для базового использования
- Подходит для простых интеграций
потоковый HTTP
- Транспорт на основе HTTP для более сложных сценариев
- Поддерживает работу без сохранения состояния
- Настраиваемый номер порта

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

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

Переменные среды:

DISCORD_TOKEN=your_discord_bot_token

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

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

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

Использование с Клодом/Курсором

Клод

Использование транспорта stdio:

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

Использование потокового HTTP-транспорта:

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js",
                "--transport",
                "http",
                "--port",
                "3000",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}

Курсор

Использование транспорта stdio:

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

Использование потокового HTTP-транспорта:

{
    "mcpServers": {
        "discord": {
            "command": "cmd",
            "args": [
                "/c",
                "node",
                "path/to/mcp-discord/build/index.js",
                "--transport",
                "http",
                "--port",
                "3000",
                "--config",
                "your_discord_bot_token"
            ]
        }
    }
}

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

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

discord_login : Войти в Discord
discord_send : отправить сообщение на указанный канал (поддерживает как идентификатор канала, так и имя канала)
discord_get_server_info : Получить информацию о сервере Discord

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

discord_create_text_channel : Создать текстовый канал
discord_delete_channel : Удалить канал

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

discord_get_forum_channels : Получить список каналов форума
discord_create_forum_post : Создать сообщение на форуме
discord_get_forum_post : Получить сообщение на форуме
discord_reply_to_forum : Ответить на сообщение на форуме
discord_delete_forum_post : Удалить сообщение на форуме

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

discord_read_messages : Чтение сообщений канала
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