discord-mcp

AI 에이전트에게 전체 Discord REST API를 노출하는 프로덕션급 Model Context Protocol 서버입니다.

상태: 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 (기본값)

stdio MCP 서버를 시작합니다. 하위 명령이 주어지지 않을 때의 기본 동작입니다.

플래그:

• --gateway — Discord Gateway 리소스 구독 활성화 (discord.js를 지연 로드함)

discord-mcp doctor

구성 및 연결 상태를 진단합니다. 0(정상), 1(경고), 2(오류)를 반환합니다.

플래그:

• --online — 네트워크 검사 실행 (Discord 토큰 확인, OTel 연결 가능 여부)

• --json — CI 사용을 위해 JSON으로 출력

오프라인 검사: 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 — CI를 위한 JSON 출력

stdin이 TTY이고 플래그가 누락된 경우, init은 대화형 마법사를 실행합니다.

discord-mcp migrate

다른 Discord/MCP 설정에서 마이그레이션합니다. 0(모두 매핑됨), 1(일부 매핑되지 않음), 2(오류)를 반환합니다.

플래그:

• --from <adapter> — 소스 어댑터 ID (--from 없이 실행 시 목록 표시)

• --source <path> — 소스 저장소 경로 (기본값: cwd)

• --json — JSON 출력

사용 가능한 어댑터: hubdustry-go-mcp (참조 구현). Plan 11에서 더 많은 어댑터가 추가될 예정입니다.

도구 표면

다음 분야에 걸쳐 192개의 도구 제공:

• messages (12)

• channels (14)

• threads (6)

• members (14)

• roles (5)

• guild (16)

• audit_log (1)

• webhooks (13)

• events (6)

• commands (15)

• users (6)

• components-v2 (8)

• intelligence (5)

• meta (1)

• reactions (5)

• emojis (5)

• app_emojis (5)

• stickers (7)

• invites (4)

• automod (5)

• interactions (8)

• application (5)

• stage_instances (4)

• soundboard (7)

• polls (2)

• voice (3)

• onboarding (2)

• monetization (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

http://localhost:5173에서 Inspector UI를 열고 tools/list를 클릭하면 192개의 모든 도구를 볼 수 있습니다.

문서

• 운영: 텔레메트리 — OTel 설정

• 운영: 복원력 — 재시도/타임아웃/회로 차단기 조정

• 운영: 감사 — 감사 싱크 + 규정 준수

라이선스

MIT — LICENSE를 참조하세요.