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

MCP-Discord 是一个 Discord MCP（模型上下文协议）服务器，可助力 AI 助手与 Discord 平台实现交互，为用户提供了一系列与 Discord 相关的实用功能。

🚀 快速开始

MCP-Discord 提供了与 Discord 交互的丰富功能，如登录 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 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 机器人
discord.login();
// 注销登录的 Discord 机器人
discord.logout();
// 获取指定服务器的信息
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。