MCP-Discord

MCP-Discord

site icon
2025.03.29 6
TypeScriptDiscord 交互AI 助手集成自动化管理交流协作
MCP-Discord 是一个基于 Model Context Protocol (MCP) 的 Discord 服务,旨在为 AI 助手提供与 Discord 平台交互的能力。该服务通过一系列功能模块,实现了 Discord 服务器的管理、消息处理、论坛操作以及 Webhook 管理等功能。
View on GitHub

Overview

基本能力

产品定位

MCP-Discord 是一个专为 AI 助手设计的 Discord 交互服务,通过 MCP 协议实现与 Discord 平台的无缝集成。

核心功能

  • 基础功能:登录 Discord 机器人、获取服务器信息、发送消息到指定频道
  • 频道管理:创建/删除文本频道
  • 论坛功能:获取论坛频道列表、创建/删除/回复论坛帖子
  • 消息与反应:读取/删除频道消息、添加/移除消息反应
  • Webhook 管理:创建/编辑/删除/使用 Webhook

适用场景

  • AI 助手与 Discord 社区的自动化交互
  • Discord 服务器的自动化管理
  • 论坛帖子的自动化处理
  • 通过 Webhook 实现消息自动化推送

工具列表

  • 基础功能工具discord_login, discord_send, discord_get_server_info
  • 频道管理工具discord_create_text_channel, discord_delete_channel
  • 论坛功能工具discord_get_forum_channels, discord_create_forum_post, discord_get_forum_post, discord_reply_to_forum, discord_delete_forum_post
  • 消息与反应工具discord_read_messages, discord_add_reaction, discord_add_multiple_reactions, discord_remove_reaction, discord_delete_message
  • Webhook 管理工具discord_create_webhook, discord_send_webhook_message, discord_edit_webhook, discord_delete_webhook

常见问题解答

  • 权限问题:确保 Discord 机器人已启用 Message Content Intent、Server Members Intent 和 Presence Intent
  • 配置问题:可通过环境变量或 --config 参数提供 Discord 机器人令牌

使用教程

使用依赖

  • Node.js (v16.0.0 或更高版本)
  • npm (v7.0.0 或更高版本)
  • 具有适当权限的 Discord 机器人
  • Discord Developer Portal 获取机器人令牌
  • 启用 Message Content Intent
  • 启用 Server Members Intent
  • 启用 Presence Intent
  • Discord 服务器权限:
  • 发送消息
  • 创建公共线程
  • 在线程中发送消息
  • 管理线程
  • 管理频道
  • 添加反应

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @barryyip0625/mcp-discord --client claude

手动安装

git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord
npm install
npm run build

调试方式

开发模式

npm run dev

配置方式

  1. 通过环境变量:
DISCORD_TOKEN=your_discord_bot_token
  1. 通过 --config 参数:
node path/to/mcp-discord/build/index.js --config "{\"DISCORD_TOKEN\":\"your_discord_bot_token\"}"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。