MCP-Discord

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

概述

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

• 登录 Discord 机器人
• 获取服务器信息
• 读取/删除频道消息
• 向指定频道发送消息（使用频道 ID 或频道名称）
• 获取论坛频道列表
• 创建/删除/回复论坛帖子
• 创建/删除文本频道
• 添加/移除消息反应
• 创建/编辑/删除/使用 Webhook

目录

• 先决条件
• 安装
• 配置
• 工具文档
  • 基本功能
  • 频道管理
  • 论坛功能
  • 消息和反应
  • Webhook 管理
• 开发
• 许可证

先决条件

• Node.js（v16.0.0 或更高版本）

• npm（v7.0.0 或更高版本）

• 一个具有适当权限的 Discord 机器人

  • 机器人令牌（可从 Discord 开发者门户 获取）
  • 启用消息内容意图
  • 启用服务器成员意图
  • 启用存在意图

• 您的 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 服务器，您必须先将机器人添加到该服务器。
使用下面的邀请链接将机器人添加到您的目标服务器。

安装

通过 Smithery 安装

要通过 Smithery 自动安装 mcp-discord

手动安装

# 克隆仓库
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord

# 安装依赖
npm install

# 编译 TypeScript
npm run build

配置

正常运行需要 Discord 机器人令牌。服务器支持两种传输方法：stdio 和可流式 HTTP。

传输方法

1. stdio（默认）

   • 传统的 stdio 传输，用于基本用途
   • 适用于简单的集成

2. 可流式 HTTP

   • 基于 HTTP 的传输，适用于更高级的场景
   • 支持无状态操作
   • 可配置端口号

配置选项

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

1. 环境变量：

DISCORD_TOKEN=您的_discord_机器人令牌

2. 使用命令行参数：

# 对于 stdio 传输（默认）
node build/index.js --config "您的_discord_机器人令牌"

# 对于可流式 HTTP 传输
node build/index.js --transport http --port 3000 --config "您的_discord_机器人令牌"

与 Claude/Cursor 的使用

Claude

1. 使用 stdio 传输：

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js",
                "--config",
                "您的_discord_机器人令牌"
            ]
        }
    }
}

2. 使用可流式 HTTP 传输：

{
    "mcpServers": {
        "discord": {
            "command": "node",
            "args": [
                "path/to/mcp-discord/build/index.js",
                "--transport",
                "http",
                "--port",
                "3000",
                "--config",
                "您的_discord_机器人令牌"
            ]
        }
    }
}

Cursor

1. 使用 stdio 传输：

{
    "mcpServers": {
        "discord": {
            "command": "cmd",
            "args": [
                "/c",
                "node",
                "path/to/mcp-discord/build/index.js",
                "--config",
                "您的_discord_机器人令牌"
            ]
        }
    }
}

2. 使用可流式 HTTP 传输：

{
    "mcpServers": {
        "discord": {
            "command": "cmd",
            "args": [
                "/c",
                "node",
                "path/to/mcp-discord/build/index.js",
                "--transport",
                "http",
                "--port",
                "3000",
                "--config",
                "您的_discord_机器人令牌"
            ]
        }
    }
}

工具文档

基本功能

• discord_send：向指定频道发送消息（支持频道 ID 和频道名称）
• discord_get_server_info：获取 Discord 服务器信息

频道管理

• discord_create_text_channel：创建文本频道
• discord_delete_channel：删除频道

论坛功能

• discord_get_forum_channels：获取论坛频道列表
• discord_create_forum_post：创建论坛帖子
• discord_get_forum_post：获取论坛帖子
• discord_reply_to_forum：回复论坛帖子
• discord_delete_forum_post：删除论坛帖子

消息和反应

• discord_read_messages：读取频道消息
• 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

开发

# 开发模式
npm run dev

许可证

MIT 许可证