MCP-Discord

MCP-Discord

Discord MCP（模型上下文协议）服务器，使 AI 助手能够与 Discord 平台进行交互。

概述

MCP-Discord 提供以下与 Discord 相关的功能：

• 登录 Discord 机器人
• 获取服务器信息
• 读取/删除频道消息
• 发送消息到指定频道
• 检索论坛频道列表
• 创建/删除/回复论坛帖子
• 创建/删除文本通道
• 添加/删除消息反应
• 创建/编辑/删除/使用 webhook

目录

• 先决条件
• 安装
• 配置
• 工具文档
  • 基本功能
  • 渠道管理
  • 论坛功能
  • 消息和反应
  • Webhook 管理
• 发展
• 执照

先决条件

• Node.js（v16.0.0 或更高版本）
• npm（v7.0.0 或更高版本）
• 具有适当权限的 Discord 机器人
  • 机器人令牌（可从Discord 开发者门户获取）
  • 已启用消息内容意图
  • 已启用服务器成员意图
  • 已启用 Presence Intent
• Discord 服务器中的权限：
  • 发送消息
  • 创建公共主题
  • 在主题中发送消息
  • 管理线程
  • 管理频道
  • 添加反应

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 mcp-discord：

手动安装

配置

正常运行需要 Discord 机器人令牌。您可以通过两种方式提供令牌：

1. 环境变量：

2. 启动时使用--config参数：

增强的启动脚本

该项目包含一个增强的启动脚本（ start-discord.js ），可提供更好的调试和错误处理：

• 从 .env 文件加载环境变量
• 如果未提供，则设置默认服务器和频道 ID
• 将 console.log 重定向到 stderr，以避免 Claude Desktop 中出现 JSON 解析问题
• 在启动 MCP 服务器之前直接测试 Discord 连接
• 如果出现任何问题，提供详细的错误信息

要使用此脚本：

与 Claude/Cursor 一起使用

• 克劳德
  { "mcpServers": { "discord": { "command": "node", "args": [ "path/to/mcp-discord/start-discord.js" ], "env": { "DISCORD_TOKEN": "your_discord_bot_token", "DEFAULT_SERVER_ID": "your_default_server_id", "DEFAULT_CHANNEL_ID": "your_default_channel_id" } } } }
• 光标
  { "mcpServers": { "discord": { "command": "cmd", "args": [ "/c", "node", "path/to/mcp-discord/start-discord.js" ], "env": { "DISCORD_TOKEN": "your_discord_bot_token", "DEFAULT_SERVER_ID": "your_default_server_id", "DEFAULT_CHANNEL_ID": "your_default_channel_id" } } } }

工具文档

基本功能

• discord_login ：登录 Discord
• discord_list_guilds ：列出所有可用的 Discord 服务器（公会）及其频道
• discord_send ：向指定频道发送消息
• discord_get_server_info ：获取 Discord 服务器信息

渠道管理

• 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 频道创建一个新的 webhook
• discord_send_webhook_message ：使用 webhook 向 Discord 频道发送消息
• discord_edit_webhook ：编辑 Discord 频道的现有 webhook
• discord_delete_webhook ：删除 Discord 频道的现有 webhook

发展

执照

MIT 许可证