discord-mcp

Сервер Model Context Protocol промышленного уровня, предоставляющий полный доступ к Discord REST API для ИИ-агентов.

Статус: v0.9.0 · 192 инструмента · OTel-инструментарий · Cockatiel-устойчивость · Аудит-логирование

См. спецификацию дизайна для ознакомления с архитектурой.

Быстрый старт

# 1. Install
npm install -g @discord-mcp/cli  # or use npx

# 2. Bootstrap config for your MCP client
discord-mcp init --client claude-desktop --token "Bot YOUR.BOT.TOKEN"

# 3. Verify configuration
discord-mcp doctor --online

# 4. Run (or let your MCP client launch it)
discord-mcp serve

Подкоманды

discord-mcp serve (по умолчанию)

Запуск MCP-сервера через stdio. Это действие по умолчанию, если подкоманда не указана.

Флаги:

• --gateway — Включить подписки на ресурсы Discord Gateway (ленивая загрузка discord.js)

discord-mcp doctor

Диагностика конфигурации и подключения. Завершается с кодом 0 (исправно), 1 (предупреждения) или 2 (ошибки).

Флаги:

• --online — Запустить сетевые проверки (проверка токена Discord, доступность OTel)

• --json — Вывод в формате JSON для использования в CI

Офлайн-проверки: node-version, token-format, env-vars, audit-sink, client-caps Онлайн-проверки (с флагом --online): token-online, otel-reachable

discord-mcp init

Настройка конфигурации + генерация фрагмента конфигурации MCP-клиента.

Флаги:

• --token <token> — Токен бота Discord (или плейсхолдер ${env:DISCORD_TOKEN})

• --client <id> — Клиент: claude-desktop, claude-code, cursor или generic

• --output <path> — Записать фрагмент в файл (по умолчанию: stdout)

• --force — Перезаписать существующий выходной файл

• --gateway — Включить Discord Gateway в сгенерированной конфигурации

• --json — JSON-вывод для CI

Если stdin является TTY и флаги отсутствуют, init запускает интерактивный мастер настройки.

discord-mcp migrate

Миграция с другой установки Discord/MCP. Завершается с кодом 0 (все сопоставлено), 1 (некоторые не сопоставлены), 2 (ошибки).

Флаги:

• --from <adapter> — ID исходного адаптера (запустите без --from для списка)

• --source <path> — Путь к исходному репозиторию (по умолчанию: cwd)

• --json — JSON-вывод

Доступные адаптеры: hubdustry-go-mcp (эталонная реализация). Больше в Плане 11.

Поверхность инструментов

192 инструмента, включая:

• сообщения (12)

• каналы (14)

• ветки (6)

• участники (14)

• роли (5)

• гильдия (16)

• audit_log (1)

• вебхуки (13)

• события (6)

• команды (15)

• пользователи (6)

• компоненты-v2 (8)

• интеллект (5)

• мета (1)

• реакции (5)

• эмодзи (5)

• эмодзи приложения (5)

• стикеры (7)

• приглашения (4)

• авто-модерация (5)

• взаимодействия (8)

• приложение (5)

• экземпляры сцены (4)

• саундборд (7)

• опросы (2)

• голос (3)

• онбординг (2)

• монетизация (8)

Локальная разработка

Предварительные требования: Node ≥20.11, pnpm ≥9.15.

pnpm install
pnpm build
pnpm test

Дымовое тестирование (реальный Discord)

Установите DISCORD_TOKEN в значение реального токена бота с сайта https://discord.com/developers/applications:

export DISCORD_TOKEN="Bot YOUR_TOKEN_HERE"
node packages/mcp-server/dist/cli.js

Затем используйте MCP Inspector в другом терминале:

npx -y @modelcontextprotocol/inspector node packages/mcp-server/dist/cli.js

Откройте интерфейс Inspector по адресу http://localhost:5173, нажмите tools/list, и вы должны увидеть все 192 инструмента.

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

• Операции: телеметрия — Настройка OTel

• Операции: устойчивость — Настройка повторных попыток/тайм-аутов/цепей

• Операции: аудит — Аудит-приемники + соответствие требованиям

Лицензия

MIT — см. LICENSE.