Discord AI对话工具

一个在Discord中通过AI自动响应和操作的工具,支持OpenAI Codex CLI和Claude Code等多种AI服务,用于自动回复和服务器管理。

  • by RazielAI
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 RazielAI/discord-mcp-server

使用说明

🇺🇸 英语 | 🇯🇵 日本语 | 🇨🇳 中文

断开MCP服务器

这是一个可以在Discord上与AI对话的工具。

只要用Discord进行分类,OpenAI的Codex CLI就会自动回复。
另外,23个MCP工具可以通过Codex/Claude Code/Cursor等AI进行Discord操作。


这是什么?

这是在你的电脑上移动AI(Codex CLI),与Discord连接的工具。

Discordで @MyBot これどう思う?
  ↓
あなたのPCでCodexが考える
  ↓
Discordに自動で返事が来る

2种使用方法(可同时使用)

🗣️ 监听模式-从Discord搭话时自动回复

在Discord中加入bot后,Codex会在背面启动并自动回复。
你只是在看Discord。 启动侦听器后,无需打开Codex。

🔧 MCP工具模式—使用AI中的Discord

如果从Codex CLI或Claude Code指示“读#general”“制作线程”,AI就会操作Discord。
这边你指示AI使用。


需要的东西

1.AI(其中一个就OK)

|服务|费用|备注| |---------|------|------| | OpenAI Plus/Pro/团队 $20〜/月\\订阅完毕可直接使用Codex CLI \\ | OpenAI API 按需计费($5至/月)用于API密钥。没有订阅也可以 | 无烟煤API |従量课金($5〜/月目安)| Claude Codeの头脑。Claudeが应答を生成|

💡 OpenAI Plus/Pro/Team订阅中描述的场景,使用下列步骤创建明细表,以便在概念设计中分析体量的周长。
首次启动时 codex 请用命令登录。

2.在电脑上安装的东西

软件|安装方法|确认命令| |-------|----------------|-------------| | Node.js(v18以上) | nodejs.org 从下载 node --version | | Codex CLI | npm install -g @openai/codex | codex --version |

💡 使用Claude Code时: npm install -g @anthropic-ai/claude-code 中所述方法的备选方法。
只要是Codex/Claude Code/Cursor/Windsurf/Crine等支持MCP的AI,MCP工具模式什么都可以使用。

3.Discord Bot(可以免费制作)

Bot是“AI的手脚”。AI是阅读和写Discord所必需的。
按照以下步骤5分钟就能做好。


设置(所有步骤)

步骤1:创建Discord Bot

  1. Discord开发者门户 (使用Discord帐户登录)
  2. 右上角 “新申请” -创建名称
  3. 单击功能区上 “机器人” 来修改标记元素的显示属性
  4. “重置令牌” -复制显示的标记(这是最重要的。稍后使用)
  5. 在同一画面上开中选择另一种天花板类型
    • ✅ 消息内容意图(为了阅读信息内容)
    • ✅ 服务器成员意图(使用成员信息时)
  6. 单击功能区上 “OAuth2→ URL生成器 来修改标记元素的显示属性
  7. 用作用域 bot 检查
  8. 按权限检查:
    • Send Messages / Read Message History / Add Reactions
    • Manage Messages / Manage Channels / Manage Threads / Embed Links
  9. 复制屏幕底部生成的URL-在浏览器中打开-选择要邀请Bot的服务器

⚠️ 令牌千万不要给别人看。 如果显示,请立即在Reset Token中重新生成。

步骤2:下载和安装

git clone https://github.com/RazielAI/discord-mcp-server.git
cd discord-mcp-server
npm install

💡 如果没有git:可以从GitHub页面通过“Code→Download ZIP”下载并解压缩。

步骤3A:使用侦听器模式(自动响应)

用Discord搭话的话AI会自动回复的模式。 这样就可以了。

🟢 简单的方法(推荐)

  1. config.toml.example 的 config.toml 重名
  2. config.toml 在文本编辑器中打开discord_bot_token = "" 的,之 "" 中粘贴步骤1的标记
  3. 窗户: start.bat 列表框中,此格式对应于条目“无”
  4. Mac/Linux: 在终点站 ./start.sh 执行

只有这个!第一次是自动的 npm install 中所述修改相应参数的值。

命令启动时

Mac/Linux:

DISCORD_BOT_TOKEN="ステップ1でコピーしたトークン" node discord-listener.js

Windows(PowerShell):

$env:DISCORD_BOT_TOKEN="ステップ1でコピーしたトークン"
node discord-listener.js

启动后,请尝试在Discord中对bot进行成员(@Bot名)。自动回复🎉

监听程序设置(可选)

可以在环境变量中进行详细设置。DISCORD_BOT_TOKEN以外全部可选是。

变数 说明
DISCORD_BOT_TOKEN 必须。 Bot令牌|
DISCORD_GUILD_ID |仅限于特定服务器(如果不指定,所有服务器都会响应)|
DISCORD_CHANNEL_ID |仅限于特定频道|
CODEX_PATH Codex CLI的路径(自动检测,通常不需要)
CODEX_WORKSPACE |Codex工作目录|
CODEX_TIMEOUT_MS |超时(默认值:120秒)|
BOT_SYSTEM_PROMPT 定制AI的性格和规则
BOT_NAME Bot表示名
MAX_HISTORY 会话存储数(默认值:15条消息)

自定义提示示例

BOT_SYSTEM_PROMPT="あなたはプログラミング専門のAIアシスタントです。技術的な質問に日本語で答えてください。" \
DISCORD_BOT_TOKEN="your-token" \
node discord-listener.js

步骤3B:使用MCP工具模式(AI到Discord操作)

从Codex CLI和Claude Code指示“读Discord的#general”的模式。

Codex CLI时

~/.codex/config.toml 添加:

[mcp_servers.discord]
type = "stdio"
command = "node"
args = ["/path/to/discord-mcp-server/discord-mcp-server.js"]

[mcp_servers.discord.env]
DISCORD_BOT_TOKEN = "ステップ1でコピーしたトークン"
DISCORD_CHANNEL_ID = "デフォルトのチャンネルID"
DISCORD_GUILD_ID = "サーバーID"

💡 /path/to/ 请用实际路径替换。示例: /Users/you/discord-mcp-server/discord-mcp-server.js

codex
# → 「Discordの #general を読んで」と入力

对于Claude Code

项目名称 .mcp.json 添加到:

{
  "mcpServers": {
    "discord": {
      "command": "node",
      "args": ["/path/to/discord-mcp-server/discord-mcp-server.js"],
      "env": {
        "DISCORD_BOT_TOKEN": "ステップ1でコピーしたトークン",
        "DISCORD_CHANNEL_ID": "デフォルトのチャンネルID"
      }
    }
  }
}

💡 只要是支持MCP的AI客户端,什么都可以连接(Cursor、Windsurf、Cline等)。

步骤3C:两者同时使用

侦听器(自动应答)和MCP工具(AI操作)可以同时移动。

终端1:

DISCORD_BOT_TOKEN="your-token" node discord-listener.js

终端2:

codex  # config.tomlにMCP設定済み

同时使用相同的Bot令牌即可。因为是不同的进程,所以不干涉。


一直运转(常驻化)

要关闭终端并使Bot继续移动:

使用pm2的方法(推荐)

# pm2をインストール
npm install -g pm2

# リスナーを起動
DISCORD_BOT_TOKEN="your-token" pm2 start discord-listener.js --name discord-bot

# PC再起動後も自動起動
pm2 save
pm2 startup

管理命令:

pm2 status         # 状態確認
pm2 logs discord-bot  # ログ確認
pm2 restart discord-bot  # 再起動
pm2 stop discord-bot     # 停止

MCP工具一览(23个)

|类别|工具|能做的事| |---------|-------|-----------| | 💬 消息 discord_send |消息发送(长句自动分割)| | | discord_reply |回复特定消息| | | discord_edit 编辑Bot发送的消息 | | discord_delete 邮件删除 | | discord_read 获取消息历史记录(支持分页) | | discord_search 在频道中搜索消息 | 👍 反应,反应 discord_react 添加图画文字反应 | 🧵 线程 discord_thread_create 创建线程 | | discord_thread_list |活动线程一览| | 📺 频道 discord_channel_list 频道一览 | | discord_channel_info |频道详细信息| | | discord_channel_create 新建频道 | | discord_channel_edit |更改频道名称、主题| | | discord_channel_delete 删除频道 | | discord_set_topic 主题设置 | 📌 管脚 discord_pin 把信息钉住 | | discord_unpin 解锁 | | discord_pins_list |别针固定信息一览| | 👥 服务器| discord_server_info 服务器信息 | | discord_member_list |成员列表| | | discord_member_info |成员详细信息| | 🎨 富集发送 discord_send_embed 发送装饰消息 | 🤖 其他 discord_whoami 自己的信息


常见问题解答

问:监听模式和MCP模式,使用哪一种?
A:从Discord搭话想要回复→听众模式。想从AI操作Discord→MCP模式。两个都推荐同时。

问:要花多少钱?
A:Discord Bot是免费的。只有OpenAI API的费用。如果是普通的对话,每月$5~10左右。如果使用GPT-4o mini的话会更便宜。

Q:ChatGPT Plus和Claude Pro收费的话可以使用吗?
A. 如果已经加入OpenAI Plus/Pro/Team,Codex CLI就可以直接使用了。 首次启动时 codex 中所述修改相应参数的值。对于“安全代码”,需要单独的API密钥。

Q:Codex以外的AI也能使用吗?
A:MCP模式只要是支持MCP的AI,什么都可以(Claude Code,Cursor,Windsurf,Cline等)。侦听器模式默认为Codex CLICODEX_PATH 对较大场景进行渲染期间已观察到该故障。

Q:多台服务器可以使用吗?
A:好的。DISCORD_GUILD_ID 中描述的场景,使用下列步骤创建明细表,以便在概念设计中分析体量的周长。

Q:安全性没问题吗?
答:令牌由环境变量管理(不写在代码中)。在侦听器模式下 --sandbox read-only 中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。

Q:关闭终端后Bot停止
A. 常驻程序 来修改标记元素的显示属性。使用pm2的话,电脑重启后也会自动启动。


故障排除

症状 原因 対処
node: command not found 里面没有Node.js nodejs.org 从安装
codex: command not found 没有Codex CLI npm install -g @openai/codex
在Developer Portal的Bot选项卡上启用
Error: TOKEN_INVALID 标记错误,重新获取
Missing Access Bot权限不足-重新生成OAuth2 URL-添加并重新邀请权限
侦听器移动,但Codex错误 codex 执行一次登录或设置API密钥

许可证

麻省理工学院