MCP-Discord

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

概述

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

• 登录 Discord 机器人

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

• 获取服务器信息

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

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

• 在服务器中搜索消息

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

• 向指定频道发送消息

• 获取论坛频道列表

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

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

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

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

• 添加/移除消息反应

• 创建/编辑/删除/使用 Webhook

Related MCP server: MCP-Discord

目录

• 先决条件

• 安装

• 配置

• 工具文档

  • 基础功能

  • 频道管理

  • 论坛功能

  • 消息与反应

  • Webhook 管理

  • 角色管理

  • 成员管理

• 开发

• 许可证

先决条件

• 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）：

    • 管理员 (完全访问权限)： https://discord.com/oauth2/authorize?client\\\\_id=INSERT\\\\_CLIENT\\\\_ID\\\\_HERE\\\\&scope=bot\\\\&permissions=8

    • 自定义权限 (最低要求)： https://discord.com/oauth2/authorize?client\\\\_id=INSERT\\\\_CLIENT\\\\_ID\\\\_HERE\\\\&scope=bot\\\\&permissions=52076489808

注意：
根据 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

2. 使用命令行参数：

# 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 许可证