
MCP-Discord

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
配置方式
- 通过环境变量:
DISCORD_TOKEN=your_discord_bot_token
- 通过
--config
参数:
node path/to/mcp-discord/build/index.js --config "{\"DISCORD_TOKEN\":\"your_discord_bot_token\"}"