Skip to main content
Glama

MCP-Discord

Docker Hub

AI 어시스턴트가 Discord 플랫폼과 상호작용할 수 있도록 지원하는 Discord MCP(Model Context Protocol) 서버입니다.

개요

MCP-Discord는 다음과 같은 Discord 관련 기능을 제공합니다:

  • Discord 봇 로그인

  • 봇이 속한 서버 목록 확인

  • 서버 정보 가져오기

  • 멤버 목록 확인 및 멤버 세부 정보 조회

  • 역할(Role) 목록 조회, 생성, 편집, 삭제, 할당 및 제거

  • 서버 내 메시지 검색

  • 채널 메시지 읽기, 편집 및 삭제

  • 지정된 채널로 메시지 전송

  • 포럼 채널 목록 검색

  • 포럼 게시물 생성, 업데이트, 삭제 및 답글 작성

  • 포럼 스레드 목록 조회 및 포럼 태그 관리

  • 텍스트, 포럼, 음성 채널 및 카테고리 생성, 편집 및 삭제

  • 채널 권한 재정의 설정 및 제거

  • 메시지 반응 추가/제거

  • 웹훅(Webhook) 생성/편집/삭제/사용

Related MCP server: MCP-Discord

목차

사전 요구 사항

참고: Discord의 보안 모델에 따라, 봇은 명시적으로 추가된 서버의 정보에만 액세스할 수 있습니다. 이 MCP 서버를 사용하여 특정 Discord 서버에 액세스하려면 먼저 해당 서버에 봇을 추가해야 합니다. 아래 초대 링크를 사용하여 대상 서버에 봇을 추가하세요.

설치

NPM을 통한 설치

다음 명령어를 사용하여 사용할 수 있습니다:

npx mcp-discord --config ${DISCORD_TOKEN}

자세한 내용은 NPM 패키지를 확인하세요.

Smithery를 통한 설치

Smithery를 통해 mcp-discord를 자동으로 설치하려면

Docker를 통한 설치

Docker를 사용하여 mcp-discord를 실행할 수 있습니다. Docker 이미지는 자동으로 빌드되어 Docker Hub에 게시됩니다.

Docker Hub 저장소: barryy625/mcp-discord

Docker는 기본적으로 build/app.js를 통해 스트리밍 가능한 HTTP 서버를 사용합니다.

# Pull the latest image
docker pull barryy625/mcp-discord:latest

# Run HTTP server on port 8080
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 8080:8080 barryy625/mcp-discord:latest

# Override the listening port if needed
docker run -e DISCORD_TOKEN=your_discord_bot_token -p 3000:3000 barryy625/mcp-discord:latest --transport http --port 3000

사용 가능한 태그:

  • latest - 메인 브랜치의 최신 안정 버전

  • v1.3.8 등 - 특정 버전 릴리스

수동 설치

# Clone the repository
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord

# Install dependencies
npm install

# Compile TypeScript
npm run build

구성

정상적인 작동을 위해서는 Discord 봇 토큰이 필요합니다. 서버는 stdio와 스트리밍 가능한 HTTP라는 두 가지 전송 방식을 지원합니다.

전송 방식

  1. stdio (기본값)

    • 기본 사용을 위한 전통적인 stdio 전송

    • 간단한 통합에 적합

  2. 스트리밍 가능한 HTTP

    • 더 고급 시나리오를 위한 HTTP 기반 전송

    • 상태 비저장(stateless) 작업 지원

    • 구성 가능한 포트 번호

구성 옵션

두 가지 방법으로 구성을 제공할 수 있습니다:

  1. 환경 변수:

DISCORD_TOKEN=your_discord_bot_token
  1. 명령줄 인수 사용:

# For stdio transport (default)
node build/index.js --config "your_discord_bot_token"

# For streamable HTTP transport
node build/app.js --transport http --port 3000 --config "your_discord_bot_token"

Claude/Cursor와 함께 사용

1. Claude/Cursor에서 Stdio 전송 사용

MCP 클라이언트가 명령 기반 stdio 서버를 예상할 때 build/index.js를 사용하세요.

Claude Desktop / Claude Code

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token"
            }
        }
    }
}

Cursor

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_discord_bot_token"
            }
        }
    }
}

이것은 로컬 명령 기반 MCP 클라이언트에 권장되는 설정입니다.

2. 스트리밍 가능한 HTTP 서버 자체 호스팅

mcp-discord를 HTTP MCP 서버로 실행하려면 build/app.js를 사용하세요.

Node.js로 실행

DISCORD_TOKEN=your_discord_bot_token node build/app.js --transport http --port 3000

Windows PowerShell에서:

$env:DISCORD_TOKEN="your_discord_bot_token"
node build/app.js --transport http --port 3000

Docker로 실행

docker run -e DISCORD_TOKEN=your_discord_bot_token -p 3000:3000 barryy625/mcp-discord:latest --transport http --port 3000

시작되면 MCP HTTP 엔드포인트는 다음과 같습니다:

http://localhost:3000/mcp

3. 호스팅된 HTTP MCP 서버에 연결

mcp-discord를 이미 다른 곳에서 호스팅 중이라면, build/app.js를 명령어로 실행하는 대신 MCP 클라이언트를 서버의 /mcp 엔드포인트로 지정하세요.

엔드포인트 예시:

https://your-server.example.com/mcp

중요 참고 사항:

  • build/app.js는 HTTP 서버를 시작합니다. stdio를 사용하지 않습니다.

  • build/index.js는 명령 기반 stdio MCP 클라이언트를 위한 올바른 진입점입니다.

  • 호스팅된 HTTP 사용의 경우, 배포 시 제공된 HTTP 엔드포인트 URL에 연결하도록 MCP 클라이언트를 구성하세요.

  • 정확한 HTTP 클라이언트 구성 형식은 사용하는 MCP 클라이언트에 따라 다릅니다.

도구 문서

기본 기능

  • discord_login: 구성된 토큰을 사용하여 Discord에 로그인

  • discord_list_servers: 봇이 속한 모든 Discord 서버 목록 조회

  • discord_send: 지정된 채널로 메시지 전송

  • discord_get_server_info: Discord 서버 정보 가져오기

채널 관리

  • discord_create_text_channel: 텍스트 채널 생성

  • discord_create_forum_channel: 포럼 채널 생성

  • discord_create_voice_channel: 음성 채널 생성

  • discord_edit_channel: 채널 이름, 주제, 상위 카테고리 또는 위치 편집

  • discord_delete_channel: 채널 삭제

  • discord_create_category: 채널 카테고리 생성

  • discord_edit_category: 채널 카테고리 편집

  • discord_delete_category: 채널 카테고리 삭제

  • discord_set_channel_permissions: 채널/카테고리에 대한 역할 또는 사용자의 권한 재정의 설정

  • discord_remove_channel_permissions: 채널/카테고리에서 권한 재정의 제거

포럼 기능

  • discord_get_forum_channels: 포럼 채널 목록 가져오기

  • discord_create_forum_post: 포럼 게시물 생성

  • discord_get_forum_post: 포럼 게시물 가져오기

  • discord_list_forum_threads: 포럼 채널의 활성 및 보관된 스레드 목록 조회

  • discord_reply_to_forum: 포럼 게시물에 답글 작성

  • discord_get_forum_tags: 포럼 채널에서 사용 가능한 모든 태그 가져오기

  • discord_set_forum_tags: 포럼 채널에서 사용 가능한 태그 교체

  • discord_update_forum_post: 포럼 게시물의 제목, 태그, 보관 상태 또는 잠금 상태 업데이트

  • discord_delete_forum_post: 포럼 게시물 삭제

메시지 및 반응

  • discord_search_messages: 서버 내 메시지 검색

  • discord_read_messages: 채널 메시지 읽기 (before, after, around 매개변수 지원 — snowflake ID 또는 ISO 8601 날짜 형식(예: "2025-03-01T00:00:00Z") 허용)

  • discord_edit_message: 봇이 작성한 메시지 편집

  • discord_add_reaction: 메시지에 반응 추가

  • discord_add_multiple_reactions: 메시지에 여러 반응 추가

  • discord_remove_reaction: 메시지에서 반응 제거

  • discord_delete_message: 채널에서 특정 메시지 삭제

웹훅 관리

  • discord_create_webhook: Discord 채널을 위한 새 웹훅 생성

  • discord_send_webhook_message: 웹훅을 사용하여 Discord 채널로 메시지 전송

  • discord_edit_webhook: Discord 채널의 기존 웹훅 편집

  • discord_delete_webhook: Discord 채널의 기존 웹훅 삭제

역할 관리

  • discord_list_roles: 서버의 모든 역할 목록 조회

  • discord_create_role: 색상, hoist, 언급 가능 여부 및 권한 옵션을 포함한 역할 생성

  • discord_edit_role: 기존 역할 편집

  • discord_delete_role: 역할 삭제

  • discord_assign_role: 멤버에게 역할 할당

  • discord_remove_role: 멤버에게서 역할 제거

멤버 관리

  • discord_list_members: 역할이 포함된 서버 멤버 목록 조회

  • discord_get_member: 특정 멤버에 대한 상세 정보 가져오기

개발

# Development mode
npm run dev

라이선스

MIT 라이선스

Available Tools

46 tools
discord_add_multiple_reactionsB

Adds multiple emoji reactions to a Discord message at once

Inputs: emojis (required), channelId (required), messageId (required).

discord_add_reactionC

Adds an emoji reaction to a specific Discord message

Inputs: emoji (required), channelId (required), messageId (required).

discord_assign_roleC

Assigns a role to a member in a Discord server

Inputs: roleId (required), userId (required), guildId (required), reason.

discord_create_categoryC

Creates a new category in a Discord server.

Inputs: name (required), guildId (required), reason, position.

discord_create_forum_channelA

Creates a new forum channel in a Discord server, optionally under a category

Inputs: name (required), guildId (required), topic, categoryId.

discord_create_forum_postB

Creates a new post in a Discord forum channel with optional tags

Inputs: title (required), content (required), forumChannelId (required), tags, +1 more.

discord_create_roleB

Creates a new role in a Discord server

Inputs: name (required), guildId (required), color, hoist, +3 more.

discord_create_text_channelA

Creates a new text channel in a Discord server with an optional topic and parent category

Inputs: guildId (required), channelName (required), topic, categoryId.

discord_create_voice_channelB

Creates a new voice channel in a Discord server with an optional parent category

Inputs: guildId (required), channelName (required), reason, userLimit, +1 more.

discord_create_webhookC

Creates a new webhook for a Discord channel

Inputs: name (required), channelId (required), avatar, reason.

discord_delete_categoryB

Deletes a Discord category by ID.

Inputs: categoryId (required), reason.

discord_delete_channelB

Deletes a Discord channel with an optional reason

Inputs: channelId (required), reason.

discord_delete_forum_postC

Deletes a forum post or thread with an optional reason

Inputs: threadId (required), reason.

discord_delete_messageB

Deletes a specific message from a Discord text channel

Inputs: channelId (required), messageId (required), reason.

discord_delete_roleA

Deletes a role from a Discord server

Inputs: roleId (required), guildId (required), reason.

discord_delete_webhookC

Deletes an existing webhook for a Discord channel

Inputs: webhookId (required), reason, webhookToken.

discord_edit_categoryB

Edits an existing Discord category (name and position).

Inputs: categoryId (required), name, reason, position.

discord_edit_channelA

Edits a Discord channel's name, topic, parent category, or position

Inputs: channelId (required), name, topic, reason, +2 more.

discord_edit_messageA

Edits a message previously sent by the bot. Only messages authored by the bot can be edited.

Inputs: content (required), channelId (required), messageId (required).

discord_edit_roleB

Edits an existing role in a Discord server

Inputs: roleId (required), guildId (required), name, color, +5 more.

discord_edit_webhookC

Edits an existing webhook for a Discord channel

Inputs: webhookId (required), name, avatar, reason, +2 more.

discord_get_forum_channelsA

Lists all forum channels in a specified Discord server (guild)

Inputs: guildId (required).

discord_get_forum_postB

Retrieves details about a forum post including its messages

Inputs: threadId (required).

discord_get_forum_tagsA

Gets all available tags for a Discord forum channel, including tag IDs, names, and emoji

Inputs: forumChannelId (required).

discord_get_memberB

Gets detailed information about a specific member in a Discord server

Inputs: userId (required), guildId (required).

discord_get_reaction_usersA

Lists the users who reacted with a specific emoji to a Discord message. Uses REST fetch and does not require Gateway intents. Returns up to 100 users per call.

Inputs: emoji (required), channelId (required), messageId (required), limit.

discord_get_server_infoB

Retrieves detailed information about a Discord server including channels and member count

Inputs: guildId (required).

discord_list_forum_threadsA

Lists all threads (posts) in a Discord forum channel, including both active and archived threads

Inputs: forumChannelId (required), limit, includeArchived.

discord_list_membersB

Lists members in a Discord server with their roles

Inputs: guildId (required), after, limit.

discord_list_pinned_messagesA

Lists the pinned messages of a channel, newest pin first.

Inputs: channelId (required), limit.

discord_list_rolesA

Lists all roles in a Discord server with their properties

Inputs: guildId (required).

discord_list_serversA

Lists all Discord servers the bot is a member of

Inputs: no named parameters.

discord_loginB

Logs in to Discord using the configured token

Inputs: token.

discord_pin_messageB

Pins a message to its channel. A channel can hold at most 50 pinned messages.

Inputs: channelId (required), messageId (required), reason.

discord_read_messagesA

Retrieves messages from a Discord text channel. Supports date-based filtering via before/after/around params (accepts snowflake IDs or ISO 8601 dates).

Inputs: channelId (required), after, limit, around, +1 more.

discord_remove_channel_permissionsA

Removes all permission overrides for a role or user on a channel or category

Inputs: roleId (required), channelId (required), reason.

discord_remove_reactionB

Removes a specific emoji reaction from a Discord message

Inputs: emoji (required), channelId (required), messageId (required), userId.

discord_remove_roleA

Removes a role from a member in a Discord server

Inputs: roleId (required), userId (required), guildId (required), reason.

discord_reply_to_forumB

Adds a reply to an existing forum post or thread

Inputs: message (required), threadId (required).

discord_search_messagesC

Searches for messages in a Discord server

Inputs: guildId (required), has, limit, maxId, +10 more.

discord_sendA

Sends a message to a specified Discord text channel. Optionally reply to another message by providing its message ID.

Inputs: message (required), channelId (required), replyToMessageId.

discord_send_webhook_messageB

Sends a message to a Discord channel using a webhook

Inputs: content (required), webhookId (required), webhookToken (required), threadId, +2 more.

discord_set_channel_permissionsA

Sets permission overrides for a role or user on a channel or category

Inputs: roleId (required), channelId (required), deny, allow, +1 more.

discord_set_forum_tagsA

Sets the available tags for a Discord forum channel. Replaces all existing tags.

Inputs: tags (required), forumChannelId (required).

discord_unpin_messageA

Removes a message from its channel's pinned messages.

Inputs: channelId (required), messageId (required), reason.

discord_update_forum_postB

Updates a forum post's title, applied tags, archived status, locked status, or pinned status. Tags can be specified by name or ID.

Inputs: threadId (required), name, tags, locked, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 46 tools

    Disambiguation3/5

    Multiple tools have overlapping purposes, such as 'discord_read_messages' vs 'discord_search_messages' and 'discord_reply_to_forum' vs 'discord_create_forum_post', which could confuse agents. The distinction between 'get', 'list', and 'read' is not always clear.

    Naming Consistency4/5

    All tools follow a consistent 'discord_verb_object' pattern, making the naming predictable. However, there is some verb variation (get, list, read, search) that slightly reduces strict consistency, but overall it is well-structured.

    Tool Count1/5

    With 46 tools, this far exceeds the recommended 3-15 scope for a well-designed MCP server. The high number of tools likely overwhelms agents and increases selection complexity, making it inappropriate for most use cases.

    Completeness2/5

    Despite the large number of tools, there are notable gaps such as missing getters for channels, webhooks, and roles (e.g., 'get_channel', 'list_webhooks'). Core operations like updating a message or deleting a webhook are present, but the surface is uneven and overfocused on creation/deletion.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Discord MCP server that enables AI assistants to interact with Discord platforms, providing functionalities like sending messages, managing channels, creating forum posts, and handling webhooks.
      21
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Discord Model Context Protocol server that enables AI assistants to interact with Discord by sending messages, managing channels, handling forum posts, managing webhooks, and processing reactions.
      22
      82 npm
      5
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Discord MCP server that enables AI assistants to interact with the Discord platform, providing features like message sending, channel management, forum operations, reactions, and webhook management.
      22
      MIT