使用说明
断开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
- Discord开发者门户 (使用Discord帐户登录)
- 右上角 “新申请” -创建名称
- 单击功能区上 “机器人” 来修改标记元素的显示属性
- “重置令牌” -复制显示的标记(这是最重要的。稍后使用)
- 在同一画面上开中选择另一种天花板类型
- ✅ 消息内容意图(为了阅读信息内容)
- ✅ 服务器成员意图(使用成员信息时)
- 单击功能区上 “OAuth2→ URL生成器 来修改标记元素的显示属性
- 用作用域
bot检查 - 按权限检查:
Send Messages/Read Message History/Add ReactionsManage Messages/Manage Channels/Manage Threads/Embed Links
- 复制屏幕底部生成的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会自动回复的模式。 这样就可以了。
🟢 简单的方法(推荐)
config.toml.example的config.toml重名config.toml在文本编辑器中打开discord_bot_token = ""的,之""中粘贴步骤1的标记- 窗户:
start.bat列表框中,此格式对应于条目“无” - 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密钥 |
许可证
麻省理工学院