JinDaGe - Discord MCP Details

article

README

🚀 MCP-Discord（模型上下文协议 - Discord）

MCP-Discord 是一个 Discord MCP（模型上下文协议）服务器，可让 AI 助手与 Discord 平台进行交互，实现如登录机器人、管理频道、处理消息等多种功能。

🚀 快速开始

MCP-Discord 提供了与 Discord 相关的丰富功能，包括但不限于：

登录到 Discord 机器人
获取服务器信息
读取/删除频道消息
发送到指定频道的消息
获取论坛频道列表
创建/删除/回复论坛帖子
创建/删除文本频道
添加/移除消息反应
创建/编辑/删除/使用网钩

📦 安装指南

先决条件

Node.js (v16.0.0 或更高版本)
npm (v7.0.0 或更高版本)
带有适当权限的 Discord 机器人
- Bot 令牌（可通过Discord 开发者门户获得）
- 需要启用的意图：message_content、messages 和 guilds
熟悉命令行和编程

安装步骤

使用 npm 安装 MCP-Discord：

# 使用 npm 安装 MCP-Discord
npm install mcp-discord

⚙️ 配置

通过环境变量配置

在你的项目根目录中创建或编辑 .env 文件，并添加以下内容：

DISCORD_TOKEN=your_discord_bot_token_here
MCP_ENDPOINT=https://mcp.discord.com

通过代码配置

在你的主文件中导入并初始化 MCP-Discord：

const { Discord } = require('mcp-discord');

async function main() {
    const discord = new Discord({
        token: 'your_discord_bot_token',
        endpoint: 'https://mcp.discord.com'
    });

    // 处理消息事件
    discord.onMessage((message) => {
        console.log(`收到消息：${message.content}`);
    });
}

main().catch(console.error);

📚 详细文档

基本功能

discord.login(): 登录到 Discord 机器人。
discord.logout(): 注销登录的 Discord 机器人。
discord.getServerInfo(guildId): 获取指定服务器的信息。

频道管理

discord.createChannel(guildId, channelName, type): 在指定服务器中创建新频道。
discord.deleteChannel(channelId): 删除指定的频道。
discord.getChannels(guildId): 获取指定服务器中的所有频道。

论坛功能

discord.createForumPost(threadId, content): 在指定的论坛线程中创建新的帖子。
discord.replyToThread(threadId, replyContent): 在指定的论坛线程中回复消息。
discord.deleteForumPost(postId): 删除指定的论坛帖子。

消息和反应

discord.sendMessage(channelId, message): 向指定频道发送消息。
discord.getMessage(messageId, channelId): 获取指定频道中的特定消息。
discord.addReaction(messageId, channelId, emoji): 在指定的消息上添加表情反应。

网钩管理

discord.createWebhook(webhookName, guildId, channelId): 为指定频道创建新的网钩。
discord.sendWebhookMessage(webhookId, webhookToken, message): 使用网钩向指定频道发送消息。
discord.deleteWebhook(webhookId): 删除指定的网钩。

💻 开发

在开发模式下启动：

# 开发模式启动
npm run dev

📄 许可证

本项目采用 MIT License。

Discord