MCP-Discord
MCP-Discord
AI 어시스턴트가 Discord 플랫폼과 상호작용할 수 있도록 지원하는 Discord MCP(Model Context Protocol) 서버입니다.
개요
MCP-Discord는 다음과 같은 Discord 관련 기능을 제공합니다:
Discord 봇 로그인
봇이 속한 서버 목록 확인
서버 정보 가져오기
멤버 목록 확인 및 멤버 세부 정보 조회
역할(Role) 목록 조회, 생성, 편집, 삭제, 할당 및 제거
서버 내 메시지 검색
채널 메시지 읽기, 편집 및 삭제
지정된 채널로 메시지 전송
포럼 채널 목록 검색
포럼 게시물 생성, 업데이트, 삭제 및 답글 작성
포럼 스레드 목록 조회 및 포럼 태그 관리
텍스트, 포럼, 음성 채널 및 카테고리 생성, 편집 및 삭제
채널 권한 재정의 설정 및 제거
메시지 반응 추가/제거
웹훅(Webhook) 생성/편집/삭제/사용
Related MCP server: MCP-Discord
목차
사전 요구 사항
Node.js (v18.0.0 이상)
npm (v7.0.0 이상)
적절한 권한이 있는 Discord 봇
봇 토큰 (Discord 개발자 포털에서 획득 가능)
Message Content Intent 활성화
Server Members Intent 활성화
Presence Intent 활성화
Discord 서버에서 필요한 권한:
가장 쉬운 설정
관리자 (빠른 설정 및 모든 기능을 위해 권장)
또는 필요한 권한만 선택:
메시지 보내기
공개 스레드 만들기
스레드에 메시지 보내기
메시지 관리
스레드 관리
채널 관리
웹훅 관리
역할 관리
반응 추가
채널 보기
Discord 봇을 서버에 추가
Discord 봇을 서버에 추가하려면 다음 초대 링크 중 하나를 사용하세요 (
INSERT_CLIENT_ID_HERE를 봇의 클라이언트 ID로 교체):
참고: 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라는 두 가지 전송 방식을 지원합니다.
전송 방식
stdio (기본값)
기본 사용을 위한 전통적인 stdio 전송
간단한 통합에 적합
스트리밍 가능한 HTTP
더 고급 시나리오를 위한 HTTP 기반 전송
상태 비저장(stateless) 작업 지원
구성 가능한 포트 번호
구성 옵션
두 가지 방법으로 구성을 제공할 수 있습니다:
환경 변수:
DISCORD_TOKEN=your_discord_bot_token명령줄 인수 사용:
# 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 3000Windows PowerShell에서:
$env:DISCORD_TOKEN="your_discord_bot_token"
node build/app.js --transport http --port 3000Docker로 실행
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/mcp3. 호스팅된 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라이선스
Available Tools
46 toolsdiscord_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
Scored across 46 tools
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.
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.
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.
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
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
An MCP server that integrates with Discord to provide AI-powered features.
Discord MCP server for ChatGPT, Claude and any AI agent: list servers and channels, read channel messages, search messages, send message, reply to message, send DM, read mentions and assign role in your own Discord account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Discord yourself; Cotlet does not store your password and you need no Discord API key. About the official Discord API: Yes, Discord has an official API for bots and OAuth2 apps, but it acts as a bot that a server manager adds, not as you, and Discord has no official MCP server for it (checked 5 Nov 2026). The MCP server on Discord's docs site only searches documentation. Setup and FAQ: https://cotlet.dev/integrations/discord-api-mcp-server
Official Duck Framework MCP server for AI-assisted development and project scaffolding.
Related MCP Servers
- AlicenseBqualityDmaintenanceA 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.211MIT
- AlicenseBqualityDmaintenanceA 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.2282 npm5MIT
- AlicenseNot gradedqualityDmaintenanceA Discord bot server based on Model Context Protocol (MCP), enabling AI models to interact with Discord through the MCP protocol.2MIT
- AlicenseBqualityDmaintenanceA 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.22MIT