Discord

🚀 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。