MCP-Discord

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

概述

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

• 登录 Discord 机器人

• 获取服务器信息

• 读取/删除频道消息

• 发送消息到指定频道

• 检索论坛频道列表

• 创建/删除/回复论坛帖子

• 创建/删除文本通道

• 添加/删除消息反应

• 创建/编辑/删除/使用 webhook

Related MCP server: MCP-Discord

目录

• 先决条件

• 安装

• 配置

• 工具文档

  • 基本功能

  • 渠道管理

  • 论坛功能

  • 消息和反应

  • Webhook 管理

• 发展

• 执照

先决条件

• Node.js（v16.0.0 或更高版本）

• npm（v7.0.0 或更高版本）

• 具有适当权限的 Discord 机器人

  • 机器人令牌（可从Discord 开发者门户获取）

  • 已启用消息内容意图

  • 已启用服务器成员意图

  • 已启用 Presence Intent

• Discord 服务器中的权限：

  • 发送消息

  • 创建公共主题

  • 在主题中发送消息

  • 管理线程

  • 管理频道

  • 添加反应

安装

通过 Smithery 安装

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

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

手动安装

# Clone the repository
git clone https://github.com/barryyip0625/mcp-discord.git
cd mcp-discord

# Install dependencies
npm install

# Compile TypeScript
npm run build

配置

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

1. 环境变量：

DISCORD_TOKEN=your_discord_bot_token
DEFAULT_SERVER_ID=your_default_server_id  # Optional
DEFAULT_CHANNEL_ID=your_default_channel_id  # Optional

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

node path/to/mcp-discord/build/index.js --config "{\"DISCORD_TOKEN\":\"your_discord_bot_token\"}"

增强的启动脚本

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

• 从 .env 文件加载环境变量

• 如果未提供，则设置默认服务器和频道 ID

• 将 console.log 重定向到 stderr，以避免 Claude Desktop 中出现 JSON 解析问题

• 在启动 MCP 服务器之前直接测试 Discord 连接

• 如果出现任何问题，提供详细的错误信息

要使用此脚本：

node start-discord.js

与 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

发展

# Development mode
npm run dev

执照

MIT 许可证