Discord MCP 服务器使用说明

项目简介

本项目 'Discord MCP Server' 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为 MCP 客户端（例如 Claude Desktop）提供与 Discord 平台交互的能力。通过此服务器，MCP 客户端可以调用预设的工具来管理 Discord 服务器，例如发送消息、读取消息、管理成员角色和频道等。

主要功能点

服务器信息查询: 获取 Discord 服务器的详细信息，例如服务器名称、成员数量等。
成员管理: 列出服务器成员及其角色。
消息管理: 在指定频道发送消息、读取最近的消息记录、对消息添加或移除反应、以及执行消息审核（删除消息和禁言用户）。
频道管理: 创建新的文本频道、删除现有频道。
角色管理: 为用户添加或移除角色。
Webhook 管理: 创建、列出、发送、修改和删除 Webhook。

安装步骤

设置 Discord Bot:
- 访问 Discord Developer Portal 创建一个新的应用。
- 在应用中创建一个 Bot，并复制 Bot 的 Token。
- 在 Bot 页面的 "Privileged Gateway Intents" 部分，启用 MESSAGE CONTENT INTENT, PRESENCE INTENT 和 SERVER MEMBERS INTENT。这些权限是服务器正常运行所必需的。
- 使用 OAuth2 URL Generator 将 Bot 邀请到您的 Discord 服务器。

克隆和安装项目:

# 克隆仓库
git clone https://github.com/hanweg/mcp-discord.git
cd mcp-discord

# 创建并激活虚拟环境 (推荐使用 uv venv)
uv venv
.venv\Scripts\activate  # Windows
source .venv/bin/activate # macOS/Linux

# 如果使用 Python 3.13+，可能需要安装 audioop 库
# uv pip install audioop-lts

# 安装项目
uv pip install -e .

配置 MCP 客户端 (以 Claude Desktop 为例): 打开 Claude Desktop 的配置文件 ('%APPDATA%\Claude\claude_desktop_config.json' on Windows, '~/Library/Application Support/Claude/claude_desktop_config.json' on macOS)。在 'servers' 字段中添加如下配置：

{
  "servers": {
    "discord": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\PATH\\TO\\mcp-discord",  // 替换为您的 mcp-discord 项目的实际路径
        "run",
        "mcp-discord"
      ],
      "env": {
        "DISCORD_TOKEN": "your_bot_token"  // 替换为您的 Discord Bot Token
      }
    }
  }
}

配置参数说明:

'command': 运行服务器的命令，这里使用 'uv' 包管理器来运行。
'args': 传递给 'command' 的参数列表。
- '--directory': 指定 MCP 服务器所在的目录。 请务必将 'C:\PATH\TO\mcp-discord' 替换为您克隆的 'mcp-discord' 仓库在您电脑上的实际路径。
- 'run mcp-discord': 指示 'uv' 运行 'mcp-discord' 包。
'env': 环境变量设置。
- 'DISCORD_TOKEN': 请务必将 'your_bot_token' 替换为您在 Discord 开发者平台获取的 Bot Token。 这是 Discord Bot 验证身份并连接到 Discord 服务器的关键。

基本使用方法

完成安装和配置后，启动 Claude Desktop。Claude Desktop 将会自动连接到 'Discord MCP Server'。您可以通过 Claude Desktop 的界面，使用自然语言指令来调用 Discord 相关的工具，例如：

"让 Bot 在 #general 频道说 'Hello, world!'" (对应 'send_message' 工具)
"告诉我 #general 频道最近的消息" (对应 'read_messages' 工具)
"获取服务器信息" (对应 'get_server_info' 工具)

具体的工具列表和使用方法可以在 Claude Desktop 的 MCP 服务器管理界面中查看。

关键词

Discord MCP 服务器使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息