Skip to main content
Glama

MCP-Discord

Docker Hub

一个 Discord MCP (模型上下文协议) 服务器,使 AI 助手能够与 Discord 平台进行交互。

概述

MCP-Discord 提供以下与 Discord 相关的功能:

  • 登录 Discord 机器人

  • 列出机器人所在的服务器

  • 获取服务器信息

  • 列出成员并查看成员详情

  • 列出、创建、编辑、删除、分配和移除角色

  • 在服务器中搜索消息

  • 读取、编辑和删除频道消息

  • 向指定频道发送消息

  • 获取论坛频道列表

  • 创建、更新、删除和回复论坛帖子

  • 列出论坛主题并管理论坛标签

  • 创建、编辑和删除文本、论坛、语音频道及分类

  • 设置和移除频道权限覆盖

  • 添加/移除消息反应

  • 创建/编辑/删除/使用 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 的传输

    • 支持无状态操作

    • 可配置端口号

配置选项

您可以通过两种方式提供配置:

  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,请将您的 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: 使用配置的令牌登录 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: 从频道中删除特定消息

Webhook 管理

  • discord_create_webhook: 为 Discord 频道创建新的 Webhook

  • discord_send_webhook_message: 使用 Webhook 向 Discord 频道发送消息

  • discord_edit_webhook: 编辑 Discord 频道的现有 Webhook

  • discord_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

许可证

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