Discord Admin MCP Server

Discord 서버 관리, 역할 관리, 멤버 제재, 채널 운영 및 메시지 관리를 위한 구조화된 도구를 제공하는 Model Context Protocol (MCP) 서버입니다.

Hermes Agency 및 모든 MCP 호환 클라이언트와 완벽하게 작동하도록 설계되었습니다.

기능 및 도구

• 서버 정보:

  • get_current_bot_user: 봇의 신원과 사용자 세부 정보를 확인합니다.

  • list_guilds: 봇이 속한 서버 목록을 나열합니다.

  • get_guild_info: 멤버 수, 소유자 ID, 서버 설정을 가져옵니다.

• 역할 관리:

  • list_roles: 서버 역할, 위치, 권한 비트필드를 나열합니다.

  • assign_role: 멤버에게 역할을 할당합니다.

  • remove_role: 멤버의 역할을 제거합니다.

  • create_role: 사용자 지정 색상과 권한으로 새 역할을 생성합니다.

  • delete_role: 서버에서 역할을 삭제합니다.

• 멤버 제재:

  • kick_member: 감사 로그 사유와 함께 멤버를 추방합니다.

  • ban_member: 선택적 메시지 삭제 기간을 지정해 멤버를 차단합니다.

  • unban_member: 멤버 차단을 해제합니다.

  • timeout_member: 설정된 시간 동안 멤버를 타임아웃(음소거/격리) 처리합니다.

• 채널 관리:

  • list_channels: 텍스트, 음선, 포럼, 공지 채널을 나열합니다.

  • create_channel: 사용자 지정 이름/카테고리/주제로 채널을 생성합니다.

  • edit_channel: 채널 이름, NSFW 상태 또는 주제를 편집합니다.

  • delete_channel: 채널을 삭제합니다.

• 메시지 관리:

  • purge_messages: 최근 메시지를 일괄 삭제합니다.

Related MCP server: Discord MCP Server

설치 및 설정

1. 요구 사항

• Python >= 3.10

• 서버 관리(Moderation) 권한과 Privileged Gateway Intents(Server Members Intent)를 갖춘 Discord 봇 토큰

2. 로컬 설치

pip install -e .

3. 환경 설정

다음 환경 변수를 설정합니다(또는 .env / ~/.hermes/.env 파일에 추가):

DISCORD_BOT_TOKEN=your_bot_token_here
DISCORD_DEFAULT_GUILD_ID=your_server_id_here  # Optional fallback

Hermes Agent 통합

~/.hermes/config.yaml에 다음을 추가합니다:

mcp_servers:
  discord_admin:
    command: "/home/kernel/hermes-venv/bin/python3"
    args: ["-m", "discord_admin_mcp.server"]
    env:
      DISCORD_BOT_TOKEN: "your_bot_token_here"

라이선스

MIT License - 저자: CommanderBiz