Dc-MCP

Discord 관리 MCP 서버 for Cursor.

Dc-MCP는 Model Context Protocol(stdio)을 통해 Cursor를 Discord 봇에 연결합니다. Cursor는 명시적 도구를 통해 길드의 전체 구조를 검사하고 정밀한 관리 작업을 실행할 수 있습니다. 자유 형식 Discord API 실행기가 아닙니다.

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

기능

• Cursor용 전체 길드 맵(discord_analyze_server / discord_server_structure)

• 채널, 역할, 멤버, 메시지, 중재, 초대, 웹훅, 감사 로그를 위한 세분화된 도구

• 중앙 권한 + 계층 검사(소유자 대상 지정 불가, 봇보다 높은 역할 불가)

• 파괴적 작업 보호(confirm=true + 선택적 하드 비활성화)

• 구조화된 JSON 결과, 비밀은 반환하거나 기록하지 않음

• Cursor의 MCP 클라이언트와 호환되는 Stdio 전송

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. 채널/역할/메시지 관리, 킥/밴, 멤버 중재, 감사 로그 보기, 웹훅/길드 관리, 메시지 보내기, 임베드 링크, 반응 추가, 메시지 기록 읽기, 즉시 초대 만들기 등의 권한으로 봇 초대

5. 관리하려는 역할/멤버를 관리할 수 있을 만큼 봇 역할을 높게 배치

6. 모든 작업을 하나의 길드로 제한하려면 DISCORD_GUILD_ID 설정

Cursor MCP 구성

프로젝트 또는 사용자 mcp.json:

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

비밀은 cwd의 .env에서 로드됩니다. 저장 후 Settings → Tools & MCP에서 discord-admin을 활성화/새로고침하세요.

CLI:

agent mcp enable discord-admin
agent mcp list

핵심 도구

또한 포함: 채널 CRUD + 권한, 역할 CRUD + 할당/제거, 멤버 중재(킥/밴/타임아웃/닉네임), 메시징(보내기/편집/삭제/고정/반응), 초대, 웹훅, discord_purge_messages.

파괴적 도구는 REQUIRE_CONFIRMATION=true일 때 confirm=true가 필요합니다.

보안

• .env를 커밋하지 마세요

• REQUIRE_CONFIRMATION=true 권장

• DISCORD_GUILD_ID로 범위 제한

• 멘션은 기본적으로 제한됨(허용되지 않으면 @everyone / 대량 역할 끄기)

• 셸, 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