SuperAPI AI 工具集

discord-mcp

discord-mcp 是一个基于 Model Context Protocol(MCP)的 Discord 集成服务器,使用 JDA(Java Discord API)构建,用于将 Discord 机器人接入 Claude、ChatGPT 等支持 MCP 的 AI 应用。它让 AI 助手能够与 Discord 交互,包括管理频道、发送与编辑消息、读取消息历史、管理角色与成员、创建邀请、管理表情、论坛频道与定时事件等,适合构建 Discord 自动化与 AI 驱动的工作流。项目以 Docker 安装为推荐方式,同时提供 Maven 运行 JAR 的方式;支持 HTTP 单例模式与 legacy stdio 模式,默认 MCP 端点 URL 为 http://localhost:8085/mcp,健康检查端点位于 http://localhost:8085/actuator/health。DISCORD_GUILD_ID 环境变量为可选,提供后可让接受 guildId 参数的工具省略该参数。

访问官网

工具介绍

用途:discord-mcp 是一个面向 Discord 的 Model Context Protocol(MCP)服务器,基于 JDA(Java Discord API),用于把 Discord 机器人集成到兼容 MCP 的应用(如 Claude、ChatGPT 等)中,使 AI 助手可以与 Discord 交互,实现频道管理、消息收发、服务器信息获取等,适合构建 Discord 自动化与 AI 驱动的工作流。

主要能力(可用工具):

  • 服务器与用户:get_server_info(获取服务器详细信息)、get_user_id_by_name(通过用户名获取用户 ID 以便 @ 提及)。
  • 私信:send_private_message、edit_private_message、delete_private_message、read_private_messages(读取私信历史,包含附件元数据,支持 count 1-100 及可选游标 before、after、around)。
  • 频道消息:send_message、edit_message、delete_message、read_messages(读取消息历史,包含附件元数据,支持 count 1-100 及可选游标)、add_reaction、remove_reaction(添加/移除表情反应)。
  • 频道管理:create_text_channel、edit_text_channel(名称、主题、nsfw、慢速模式、分类、位置)、delete_channel、find_channel、list_channels、get_channel_info、move_channel(移动到其他分类或调整位置)。
  • 分类:create_category、edit_category(重命名或移动位置)、delete_category、find_category、list_channels_in_category。
  • Webhook:create_webhook、delete_webhook、list_webhooks、send_webhook_message。
  • 角色:list_roles、create_role、edit_role、delete_role、assign_role、remove_role。
  • 成员管理:kick_member、ban_member、unban_member、timeout_member、remove_timeout、set_nickname、get_bans。
  • 语音与舞台:create_voice_channel、create_stage_channel、edit_voice_channel(名称、比特率、人数上限、区域)、move_member、disconnect_member、modify_voice_state(服务器静音或耳聋)。
  • 定时事件:create_guild_scheduled_event(语音、舞台或外部)、edit_guild_scheduled_event、delete_guild_scheduled_event、list_guild_scheduled_events、get_guild_scheduled_event_users。
  • 频道权限覆盖:list_channel_permission_overwrites、upsert_role_channel_permissions、upsert_member_channel_permissions、delete_channel_permission_overwrite。
  • 邀请:create_invite、list_invites、delete_invite(撤销)、get_invite_details(适用于任何公开邀请)。
  • 论坛频道:create_forum_channel、edit_forum_channel、list_forum_channels、get_forum_channel_info、list_forum_tags、create_forum_post、list_forum_posts、modify_forum_post(锁定/解锁、归档/取消归档、置顶/取消置顶、更改标签)。
  • 自定义表情:list_emojis、get_emoji_details、create_emoji(base64 或图片 URL,最大 256KB)、edit_emoji、delete_emoji。

使用方式:

  • 安装:推荐使用 Docker 安装(需安装 Docker,完整说明见 docker.com);也可使用 Maven 运行 JAR 作为长期运行的服务(需安装 Maven 以使用 mvn 命令)。创建 Discord 机器人并获取其 token 的说明可参见项目提供的链接。
  • 环境变量:DISCORD_GUILD_ID 为可选;提供后设置默认 Discord 服务器 ID,使所有接受 guildId 参数的工具可省略该参数。日志无需手动设置 LOGGING_PATTERN_CONSOLE,http 与 legacy stdio 模式都会自动配置日志。
  • 端点:默认 MCP 端点 URL(HTTP profile)为 http://localhost:8085/mcp;健康端点(Actuator)为 http://localhost:8085/actuator/health。
  • 客户端配置:支持将配置粘贴到 OpenClaw ~/.openclaw/config.json;Cursor 可通过 Settings -> Cursor Settings -> MCP -> Add new global MCP server 添加,推荐粘贴到 ~/.cursor/mcp.json,也可在项目文件夹创建 .cursor/mcp.json 安装到特定项目;n8n 中添加 MCP Client 节点,选择 HTTP 或 Streamable HTTP 传输,设置服务器 URL 为 http://localhost:8085/mcp,保存并测试连接,之后即可在工作流中使用 discord-mcp 暴露的 Discord 工具,若 n8n 运行在 Docker 中,localhost 可能指向 n8n 容器而非宿主机,需改用 Docker 服务名或其他可达主机,例如 http://discord-mcp:8085/mcp;Claude Desktop 支持 STDIO 本地配置(将配置粘贴到 claude_desktop_config.json)以及 Remote MCP Connector(Settings -> Connectors 添加自定义连接器并设置 MCP URL 为服务器端点,如 https://<PUBLIC_HOST>/mcp,保存并重新连接)。
  • 连接模式:推荐 HTTP 单例模式;legacy 模式为 stdio,每个客户端会话启动新进程/容器。

适用场景:构建 Discord 自动化与 AI 驱动的工作流,例如由 AI 助手管理服务器频道与分类、收发与编辑消息、管理角色与成员、创建邀请、管理论坛频道与表情、安排与管理定时事件等。

限制与注意事项:Claude Desktop 的远程连接器通过 Connectors UI 管理(不是 claude_desktop_config.json);http://localhost:8085/mcp 仅能从本机访问,用于 Claude Desktop 远程连接器时需以公共 HTTPS 暴露端点(例如隧道/反向代理)。Docker 与 Maven 的安装要求及创建 Discord 机器人、获取 token 的说明需参考对应外部链接。若设置了 DISCORD_GUILD_ID,上述工具中的 guildId 参数变为可选。更详细的示例可参见项目 Wiki。