Dc-MCP

Discord Administration MCP Server для Cursor.

Dc-MCP подключает Cursor к Discord-боту через Model Context Protocol (stdio). Cursor может просматривать полную структуру гильдии и выполнять точные административные действия с помощью явных инструментов, а не свободного исполнителя Discord API.

Cursor  ──MCP (stdio)──▶  Dc-MCP  ──discord.py──▶  Discord API

Возможности

• Полная карта гильдии для Cursor (discord_analyze_server / discord_server_structure)

• Детальные инструменты для каналов, ролей, участников, сообщений, модерации, приглашений, вебхуков и журналов аудита

• Централизованные проверки прав и иерархии (без нацеливания на владельца, без ролей выше бота)

• Защита от разрушительных действий (confirm=true + опциональное полное отключение)

• Структурированные JSON-результаты; секреты никогда не возвращаются и не логируются

• Транспорт Stdio, совместимый с MCP-клиентом Cursor

Related MCP server: Discord MCP Server

Требования

• Python 3.11+

• Приложение Discord + бот

• Привилегированные интенты: Server Members Intent, Message Content Intent

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

git clone https://github.com/669px/Dc-MCP.git
cd Dc-MCP
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .
cp .env.example .env

Отредактируйте .env:

DISCORD_BOT_TOKEN=your_bot_token
DISCORD_GUILD_ID=your_guild_id
ALLOW_DANGEROUS_ACTIONS=true
REQUIRE_CONFIRMATION=true
LOG_LEVEL=INFO

Запустите:

python -m src.main

Логи идут в stderr. stdout зарезервирован для MCP JSON-RPC.

Настройка Discord-бота

1. Создайте приложение на Discord Developer Portal

2. Добавьте бота и скопируйте токен в DISCORD_BOT_TOKEN

3. Включите Server Members Intent и Message Content Intent

4. Пригласите бота с такими разрешениями, как Manage Channels/Roles/Messages, Kick/Ban, Moderate Members, View Audit Log, Manage Webhooks/Guild, Send Messages, Embed Links, Add Reactions, Read Message History, Create Instant Invite

5. Разместите роль бота достаточно высоко, чтобы управлять ролями/участниками, которыми вы собираетесь администрировать

6. Установите DISCORD_GUILD_ID, чтобы ограничить все операции одной гильдией

Конфигурация MCP для Cursor

Проектный или пользовательский mcp.json:

{
  "mcpServers": {
    "discord-admin": {
      "command": "/ABSOLUTE/PATH/TO/Dc-MCP/.venv/bin/python",
      "args": ["-m", "src.main"],
      "cwd": "/ABSOLUTE/PATH/TO/Dc-MCP"
    }
  }
}

Секреты загружаются из .env в cwd. После сохранения включите/обновите discord-admin в Settings → Tools & MCP.

CLI:

agent mcp enable discord-admin
agent mcp list

Основные инструменты

Также включены: CRUD каналов + разрешения, CRUD ролей + назначение/снятие, модерация участников (kick/ban/timeout/nick), обмен сообщениями (send/edit/delete/pin/react), приглашения, вебхуки и discord_purge_messages.

Разрушительные инструменты требуют confirm=true, когда REQUIRE_CONFIRMATION=true.

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

• Никогда не коммитьте .env

• Предпочитайте REQUIRE_CONFIRMATION=true

• Ограничьте область с помощью DISCORD_GUILD_ID

• Упоминания по умолчанию ограничены (@everyone / массовые роли отключены, если не разрешено)

• Нет инструментов для shell, eval, HTTP-прокси или универсального исполнителя API

• Токены вебхуков никогда не возвращаются

Структура проекта

src/
  main.py              MCP entrypoint (stdio)
  config.py            Environment settings
  discord_client.py    discord.py client
  permissions.py       Guild / hierarchy / confirmation gates
  errors.py            Structured error mapping
  responses.py         Success / failure payloads
  server_map.py        Full guild analysis for Cursor
  tools/               Granular MCP tools
tests/                 Unit tests (mocked Discord)

Разработка

source .venv/bin/activate
python -m compileall src
python -m pytest
python -c "import discord; print(discord.__version__)"

Ограничения Discord

• Массовое удаление работает только для сообщений младше 14 дней

• Лимиты массового удаления/очистки по умолчанию — 100

• Нельзя модерировать владельца гильдии или цели на/выше самой высокой роли бота

• Управляемые/интеграционные роли нельзя редактировать

• Список/поиск участников требует Server Members Intent

Лицензия

MIT