MCP-Discord（模型上下文协议- 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 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