Overview
Read and send messages, manage channels and members for Discord communities.
Setup
Run with npx:
npx -y @modelcontextprotocol/server-discordConfiguration
DISCORD_BOT_TOKEN, DISCORD_GUILD_ID environment variablesDocumentation
Discord MCP
Overview
Discord MCP 是一个模型上下文协议服务器,允许 AI 代理与 Discord 进行交互。通过此 MCP 服务器,AI 可以读取频道消息、发送消息、管理频道、处理成员和角色。这对于社区管理、客户服务和团队协作场景非常有用。
Discord MCP 使得 AI 代理能够成为 Discord 机器人,自动回答问题、 Moderation、收集反馈、生成报告。它特别适合社区运营、技术支持和团队沟通自动化。
Features
- 消息读取:获取频道历史消息
- 消息发送:在频道中发送消息
- 频道管理:列出频道、获取频道详情
- 成员管理:获取成员列表、用户信息
- 角色管理:列出角色、分配角色
- 反应管理:添加和移除消息反应
- 文件处理:上传和下载附件
Installation
# 使用 npx 运行
npx -y @modelcontextprotocol/server-discord
# 或使用 uvx
uvx mcp-server-discord
Configuration
添加以下配置到 claude_desktop_config.json:
{
"mcpServers": {
"discord": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-discord"],
"env": {
"DISCORD_BOT_TOKEN": "your-bot-token",
"DISCORD_GUILD_ID": "your-guild-id"
}
}
}
}
创建 Discord Bot
- 访问 https://discord.com/developers/applications
- 创建新应用
- 转到 Bot 页面,创建 Bot 用户
- 复制 Bot Token
- 在 OAuth2 → URL Generator 中生成邀请链接
- 邀请 Bot 到你的服务器
Available Tools
| Tool | Description |
|---|---|
discord_list_channels | 列出服务器中的频道 |
discord_get_channel_messages | 获取频道历史消息 |
discord_send_message | 发送消息到频道 |
discord_get_member | 获取成员信息 |
discord_list_members | 列出服务器成员 |
discord_add_reaction | 添加消息反应 |
discord_remove_reaction | 移除消息反应 |
Usage Examples
示例 1:读取频道消息
AI: 读取 #general 频道最近 10 条消息
Discord MCP:
- 找到 #general 频道 ID
- 调用 discord_get_channel_messages
- 返回消息列表
示例 2:发送欢迎消息
AI: 当有新成员加入时,在 #welcome 频道发送欢迎消息
Discord MCP:
- 监听成员加入事件(需要配置 webhook 或轮询)
- 调用 discord_send_message 发送欢迎消息
示例 3: Moderation
AI: 检查 #chat 频道是否有违规消息,如果有则删除并警告用户
Discord MCP:
- 读取频道消息
- 分析内容是否违规
- 如有违规,调用删除消息和发送警告
Pros
- ✅ 完整的 Discord API 覆盖
- ✅ 支持消息、频道、成员管理
- ✅ 适合社区自动化
- ✅ 开源免费
- ✅ 活跃的 Discord 社区
Cons
- ❌ 需要创建 Discord Bot 并获取令牌
- ❌ 某些功能需要特定权限
- ❌ Rate limit 限制需要注意
- ❌ 需要服务器管理员权限
When to Use
- 需要 AI 辅助社区管理时
- 想要自动化 Discord 操作时
- 需要收集社区反馈时
- 想要构建 Discord 机器人时
