MCP-Discord
MCP-Discord
一个 Discord MCP (模型上下文协议) 服务器,使 AI 助手能够与 Discord 平台进行交互。
概述
MCP-Discord 提供以下与 Discord 相关的功能:
登录 Discord 机器人
列出机器人所在的服务器
获取服务器信息
列出成员并查看成员详情
列出、创建、编辑、删除、分配和移除角色
在服务器中搜索消息
读取、编辑和删除频道消息
向指定频道发送消息
获取论坛频道列表
创建、更新、删除和回复论坛帖子
列出论坛主题并管理论坛标签
创建、编辑和删除文本、论坛、语音频道及分类
设置和移除频道权限覆盖
添加/移除消息反应
创建/编辑/删除/使用 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 服务器中所需的权限:
最简设置
管理员 (推荐用于快速设置和完整功能)
或者,仅选择所需的权限:
发送消息
创建公共主题
在主题中发送消息
管理消息
管理主题
管理频道
管理 Webhook
管理角色
添加反应
查看频道
将 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 的传输
支持无状态操作
可配置端口号
配置选项
您可以通过两种方式提供配置:
环境变量:
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 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/mcp3. 连接到托管的 HTTP MCP 服务器
如果您已经在其他地方托管了 mcp-discord,请将您的 MCP 客户端指向服务器的 /mcp 端点,而不是将 build/app.js 作为命令启动。
端点示例:
https://your-server.example.com/mcp重要说明:
build/app.js启动一个 HTTP 服务器。它不使用 stdio。build/index.js是基于命令的 stdio MCP 客户端的正确入口点。对于托管的 HTTP 使用,请将您的 MCP 客户端配置为连接到您部署提供的 HTTP 端点 URL。
确切的 HTTP 客户端配置格式取决于您使用的 MCP 客户端。
工具文档
基础功能
discord_login: 使用配置的令牌登录 Discorddiscord_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: 从频道中删除特定消息
Webhook 管理
discord_create_webhook: 为 Discord 频道创建新的 Webhookdiscord_send_webhook_message: 使用 Webhook 向 Discord 频道发送消息discord_edit_webhook: 编辑 Discord 频道的现有 Webhookdiscord_delete_webhook: 删除 Discord 频道的现有 Webhook
角色管理
discord_list_roles: 列出服务器中的所有角色discord_create_role: 创建具有颜色、显示、可提及和权限选项的角色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