Discord MCP Server

什么是 Discord MCP Server？

Discord MCP 是 SaseQ 开发的开源 Model Context Protocol 服务器，它把 Discord 机器人连接到 Claude、Cursor、Codex 等 AI 助手，让它们通过 Discord API 发送和读取消息、管理频道、角色和成员，并执行管理操作。

它是社区项目，并非 Discord 官方产品。它使用 Java 和 JDA（Java Discord API）编写，作为常驻的 HTTP 服务器运行（通常在 Docker 中），地址为 http://localhost:8085/mcp。同时也支持旧版 stdio 模式，即每个客户端会话启动一个容器。

如何使用 Discord MCP Server？

前提条件： 一个 Discord 机器人令牌，以及 Docker（或使用 Java 和 Maven 自行构建 JAR）。按照 README 中链接的 discord.js 应用设置指南 创建机器人并复制令牌，然后把机器人邀请到你的服务器。

1. 设置环境变量。

export DISCORD_TOKEN="YOUR_DISCORD_BOT_TOKEN"
export DISCORD_GUILD_ID="OPTIONAL_DEFAULT_SERVER_ID"
export SPRING_PROFILES_ACTIVE=http

DISCORD_GUILD_ID 为可选项。设置后，所有接受 guildId 参数的工具都可以省略该参数。

2. 运行 Docker 容器。

docker run -d -i \
  --name discord-mcp \
  --restart unless-stopped \
  -p 8085:8085 \
  -e SPRING_PROFILES_ACTIVE \
  -e DISCORD_TOKEN \
  -e DISCORD_GUILD_ID \
  saseq/discord-mcp:latest

MCP 端点为 http://localhost:8085/mcp。README 还介绍了 Docker Compose 以及通过 mvn clean package 手动构建的方式。

Claude Code

claude mcp add discord-mcp --transport http http://localhost:8085/mcp

Cursor

在 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）中添加：

{
  "mcpServers": {
    "discord-mcp": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中使用 stdio 配置：

{
  "mcpServers": {
    "discord-mcp": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "DISCORD_TOKEN=<YOUR_DISCORD_BOT_TOKEN>",
        "-e", "DISCORD_GUILD_ID=<OPTIONAL_DEFAULT_SERVER_ID>",
        "saseq/discord-mcp:latest"
      ]
    }
  }
}

Claude Desktop 的远程连接器（Settings > Connectors）需要公网 HTTPS URL，因此若不借助隧道或反向代理，localhost 在那里无法使用。

Codex

codex mcp add discord-mcp --url http://localhost:8085/mcp

README 还介绍了 OpenClaw 以及 n8n 的 MCP Client 节点。

Discord MCP Server 的主要功能

• 基于机器人，使用 JDA 通过 Discord 官方 API 访问
• 所有客户端共享一个 HTTP 服务器，或使用旧版按会话启动的 stdio 模式
• 频道消息和私信，读取历史消息时支持 1–100 条以及 before/after/around 游标
• 服务器管理：频道、分类、角色、权限覆盖、邀请、表情和计划活动
• 管理操作：踢出、封禁、解封、禁言和修改昵称
• 论坛、语音和舞台频道管理
• 可通过 DISCORD_GUILD_ID 设置默认服务器；健康检查端点为 /actuator/health
• 采用 MIT 许可证，以 saseq/discord-mcp Docker 镜像发布

Discord MCP Server 工具

该服务器提供大量工具，按领域分组：

• 消息： send_message、read_messages、edit_message、delete_message、add_reaction 和 remove_reaction；私信通过 send_private_message 和 read_private_messages。
• 频道与分类： list_channels、find_channel、create_text_channel、edit_text_channel、move_channel、delete_channel 和 create_category。
• 角色与权限： list_roles、create_role、assign_role、remove_role 和 upsert_role_channel_permissions。
• 管理： kick_member、ban_member、unban_member、timeout_member 和 get_bans。
• 社区功能： webhook（send_webhook_message）、邀请（create_invite）、论坛（create_forum_post）、计划活动（create_guild_scheduled_event）、表情和语音频道。
• 查询： get_server_info 和 get_user_id_by_name（便于使用 <@id> 提及用户）。

Discord MCP Server 的使用场景

• 发布公告：“Post the release notes for v2.3 in #announcements.”
• 快速了解动态：“Read the last 100 messages in #support and list unanswered questions.”
• 社区搭建：“Create an Events category with text and voice channels and a Moderator role that can manage them.”
• 管理：“Time out the user spamming in #general for 10 minutes and delete their last three messages.”
• 活动：“Schedule a stage event for Friday at 6 pm and list who is interested.”
• 自动化：通过 n8n 的 MCP Client 节点把该服务器接入 n8n 工作流。

Discord MCP Server 与替代方案对比

其他 Discord MCP 服务器采用了不同做法：有的只能通过单个 webhook URL 发消息，有的以用户账号而不是机器人身份登录，这可能违反 Discord 的条款。本服务器使用机器人令牌和官方 API，权限更明确，覆盖的 API 范围也大得多。如果你的团队使用的是 Slack 而不是 Discord，请参阅 Slack MCP Server。

Discord MCP Server 常见问题排查

• 客户端无法连接： 用 docker ps --filter name=discord-mcp 确认容器正在运行，并检查 curl -fsS http://localhost:8085/actuator/health。
• Docker 中的 n8n 无法访问服务器： localhost 指向的是 n8n 容器本身。请使用 Docker 服务名，例如 http://discord-mcp:8085/mcp。
• Claude Desktop 远程连接器失败： http://localhost:8085/mcp 只能从本机访问。请使用 stdio 配置，或通过公网 HTTPS 暴露该端点。
• 工具每次都要求提供 guildId： 设置 DISCORD_GUILD_ID 作为默认值。
• 旧教程中的配置直接启动 JAR： 当前 README 以 SPRING_PROFILES_ACTIVE=http 将 JAR 作为常驻服务器运行，客户端连接 http://localhost:8085/mcp；推荐使用 Docker 安装。