Discord MCP Server 使用说明

项目简介

Discord MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当 LLM（如 Claude）与 Discord 之间的桥梁。通过此服务器，LLM 可以安全、可控地与 Discord 频道进行交互，实现消息发送和读取等功能，从而扩展 LLM 在 Discord 平台上的应用场景。

主要功能点

发送消息到 Discord 频道：允许 LLM 向指定的 Discord 频道发送文本消息。
读取 Discord 频道消息：允许 LLM 获取指定 Discord 频道的最近消息，用于上下文理解或信息检索。
自动服务器和频道发现：服务器能够自动发现bot所在的 Discord 服务器和频道，简化配置过程。
支持频道名称和ID：用户可以使用频道名称或 ID 来指定操作目标频道，提高使用灵活性。
完善的错误处理和验证：服务器具备良好的错误处理机制，确保操作的稳定性和可靠性。

安装步骤

克隆仓库

git clone https://github.com/v-3/discordmcp.git
cd discordmcp

安装依赖
```
npm install
```
配置环境变量 在项目根目录下创建 '.env' 文件，并填入您的 Discord Bot Token：
```
DISCORD_TOKEN=您的_Discord_Bot_Token
```
请务必替换 '您的_Discord_Bot_Token' 为您实际的 Discord Bot Token。
构建服务器
```
npm run build
```

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude for Desktop）连接，您需要在客户端的配置文件中添加服务器配置信息。以下是 Claude for Desktop 的配置示例，您需要根据实际情况修改 'command' 和 'DISCORD_TOKEN' 的值。

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/path/to/discordmcp/build/index.js"],
      // 请替换为 discordmcp 项目 build 目录下 index.js 文件的实际路径，例如 /Users/yourname/discordmcp/build/index.js
      "env": {
        "DISCORD_TOKEN": "您的_Discord_Bot_Token"
        // 请替换为您的 Discord Bot Token，与 .env 文件中的 token 保持一致
      }
    }
  }
}

配置说明：

'"discord"': 服务器名称，您可以自定义，用于在 MCP 客户端中标识此服务器。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行环境。
'"args": [...]': 传递给启动命令的参数，指向编译后的服务器入口文件 'index.js' 的路径。请务必根据您的实际项目路径修改此参数。
'"env": { "DISCORD_TOKEN": ... }': 设置环境变量，将 Discord Bot Token 传递给服务器。请务必替换 '您的_Discord_Bot_Token' 为您实际的 Discord Bot Token。

请注意：

'/path/to/discordmcp/build/index.js' 需要替换为 'discordmcp/build/index.js' 在您电脑上的绝对路径。
请确保您的 MCP 客户端配置文件语法正确。
配置完成后，重启您的 MCP 客户端以加载新的服务器配置。

基本使用方法

配置完成后，您可以在 MCP 客户端中通过自然语言指令调用 Discord MCP Server 提供的工具。

示例指令：

读取 'general' 频道最近 5 条消息：

Can you read the last 5 messages from the general channel?

向 'announcements' 频道发送消息 "Meeting starts in 10 minutes"：

Please send a message to the announcements channel saying 'Meeting starts in 10 minutes'

询问 'development' 频道关于最新版本的消息：

What were the most recent messages in the development channel about the latest release?

LLM 在执行这些指令时，会调用 Discord MCP Server 提供的 'read-messages' 和 'send-message' 工具，并会在执行发送消息等操作前请求您的批准。

关键词