Discord

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