Skip to main content
Glama
deenesjakoruzh
hevji

Discord MCP Server

by hevji
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Discord MCP Server

AI 코딩 어시스턴트에서 Discord 서버를 직접 관리하세요. 채널, 카테고리, 역할을 만들고, 권한을 설정하고, 역할을 할당하는 등 모든 것을 자연어로 처리할 수 있습니다.

virustotal: https://www.virustotal.com/gui/file/56fafed35e2734debed600e585741c53f456148da257065e9ea8c9fcb62c798d

도구

도구

설명

create_category

새 카테고리 채널 생성

create_channel

카테고리 아래 텍스트 또는 음성 채널 생성

create_role

색상, 별도 표시, 멘션 가능 여부로 새 역할 생성

edit_role

역할의 이름, 색상, 별도 표시, 멘션 가능 여부 편집

delete_role

역할 삭제 (관리형이 아니고 봇의 계층 아래인 역할)

assign_role

사용자 이름으로 멤버에게 역할 할당

remove_role

사용자 이름으로 멤버에게서 역할 제거

restrict_channel

채널 권한 설정 (역할 허용/거부, 읽기 전용 모드, 스레드 제어)

create_role_restricted_channel

채널 생성 + 권한 제한을 한 번의 호출로 실행

rename_channel

텍스트 또는 음성 채널 이름 변경

delete_category

카테고리 채널 삭제

delete_channel

텍스트 또는 음성 채널 삭제

list_channels

모든 채널의 이름, 유형, 카테고리 나열

list_roles

모든 역할의 이름, 색상, 멤버 수 나열

create_webhook

텍스트 채널에 웹훅 생성

send_webhook_message

기존 웹훅을 통해 메시지 전송

set_slowmode

텍스트 채널에 슬로우모드 지연(초) 설정

Related MCP server: discord-mcp

설정

1. Discord 봇 만들기

  1. https://discord.com/developers/applications로 이동합니다.

  2. 새 애플리케이션 클릭 → 이름 입력 → 만들기

  3. 봇으로 이동 → 봇 추가

  4. 특권 게이트웨이 인텐트 아래에서 다음을 활성화합니다:

    • Server Members Intent

    • Message Content Intent

  5. 토큰을 복사합니다.

  6. OAuth2 → URL 생성기로 이동합니다.

    • 범위: bot

    • 봇 권한: Administrator (또는 수동 선택: 채널 관리, 역할 관리, 멤버 추방, 웹훅 관리, 메시지 보내기, 메시지 읽기, 채널 보기)

  7. 브라우저에서 생성된 URL을 열어 봇을 서버에 초대합니다.

2. 환경 구성

cp .env.example .env

.env 파일을 편집하고 봇 토큰을 붙여넣으세요:

DISCORD_TOKEN=your_token_here

선택 사항: 이름으로 봇을 특정 서버에 고정할 수 있습니다 (기본값: Monolith). 모든 도구는 이 서버에서만 작동합니다:

DISCORD_GUILD_NAME=Monolith

3. 종속성 설치

pip install -r requirements.txt

MCP 호스트 구성

opencode

프로젝트 루트의 opencode.json에 추가하세요:

{
  "mcp": {
    "discord": {
      "type": "local",
      "command": ["python", "/absolute/path/to/discord_mcp_server.py"]
    }
  }
}

서버를 로드하려면 opencode를 다시 시작하세요.

Claude Desktop

claude_desktop_config.json 편집 (파일 → 설정 → 개발자 → 구성 편집):

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["/absolute/path/to/discord_mcp_server.py"],
      "env": {
        "DISCORD_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Code

프로젝트의 ~/.claude.json 또는 .mcp.json에 추가하세요:

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["/absolute/path/to/discord_mcp_server.py"],
      "env": {
        "DISCORD_TOKEN": "your_token_here"
      }
    }
  }
}

Cursor

프로젝트 루트에 .cursor/mcp.json 생성 (전역 설정은 ~/.cursor/mcp.json):

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["/absolute/path/to/discord_mcp_server.py"],
      "env": {
        "DISCORD_TOKEN": "your_token_here"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json에 추가하세요:

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["/absolute/path/to/discord_mcp_server.py"],
      "env": {
        "DISCORD_TOKEN": "your_token_here"
      }
    }
  }
}

Codex CLI

~/.codex/config.toml에 추가하세요:

[mcp_servers.discord]
command = "python"
args = ["/absolute/path/to/discord_mcp_server.py"]

[mcp_servers.discord.env]
DISCORD_TOKEN = "your_token_here"

또는 CLI를 통해 추가하세요:

codex mcp add discord -- python /absolute/path/to/discord_mcp_server.py

Antigravity (Google)

~/.gemini/config/mcp_config.json에 추가하세요:

{
  "mcpServers": {
    "discord": {
      "command": "python",
      "args": ["C:\\path\\to\\discord_mcp_server.py"],
      "env": {
        "DISCORD_TOKEN": "your_token_here"
      }
    }
  }
}

Antigravity → Agent 패널 → ... → MCP 서버 → MCP 서버 관리 → 원시 구성 보기를 엽니다.

참고: 인라인 env 대신 .env 파일을 사용하는 경우, env 블록을 생략하고 스크립트의 load_dotenv()가 .env 파일을 찾을 수 있도록 하세요 (작업 디렉터리는 호스트에 따라 다릅니다).

작동 방식

스크립트는 stdio를 통해 MCP 서버를 실행하며, 봇 토큰으로 Discord에 연결합니다. 시작 시 모든 도구를 등록하고, AI 어시스턴트가 필요에 따라 해당 도구를 호출합니다. Discord 봇은 한 개의 서버에만 있으면 됩니다. 로그인 시 첫 번째 서버를 자동으로 선택합니다.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • discord-mcp

    arrrnmp
    A
    license
    Not graded
    quality
    F
    maintenance
    Control your Discord server with AI. Lets you manage channels, roles, members, messages, and more through natural language.
    120 npm
    MIT

  • discord-mcp

    grooving6
    A
    license
    A
    quality
    C
    maintenance
    Enables AI clients to manage Discord servers, including channels, messages, roles, members, permissions, threads, invites, events, webhooks, and emoji, through natural language commands.
    55
    120 npm
    1
    MIT

  • MCP-Discord

    mancini8835
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to interact with Discord by managing servers, channels, roles, members, messages, forum posts, reactions, webhooks, and permissions.
    866 npm
    MIT

  • MCP-Discord

    isun98948
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to interact with the Discord platform for managing servers, channels, messages, roles, members, forums, and webhooks through natural language.
    866 npm
    MIT