discord-mcp

生产级模型上下文协议 (MCP) 服务器，将完整的 Discord REST API 暴露给 AI 代理。

状态: v0.9.0 · 192 个工具 · 已集成 OTel · 具备 Cockatiel 弹性 · 已启用审计日志

架构请参阅 设计规范。

快速开始

# 1. Install
npm install -g @discord-mcp/cli  # or use npx

# 2. Bootstrap config for your MCP client
discord-mcp init --client claude-desktop --token "Bot YOUR.BOT.TOKEN"

# 3. Verify configuration
discord-mcp doctor --online

# 4. Run (or let your MCP client launch it)
discord-mcp serve

子命令

discord-mcp serve (默认)

启动 stdio MCP 服务器。这是未指定子命令时的默认操作。

标志:

• --gateway — 启用 Discord 网关资源订阅（延迟导入 discord.js）

discord-mcp doctor

诊断配置和连接性。退出代码：0（健康）、1（警告）或 2（错误）。

标志:

• --online — 运行网络检查（Discord 令牌验证、OTel 可达性）

• --json — 以 JSON 格式输出，供 CI 使用

离线检查: node-version, token-format, env-vars, audit-sink, client-caps 在线检查 (配合 --online): token-online, otel-reachable

discord-mcp init

引导配置 + 生成 MCP 客户端配置片段。

标志:

• --token <token> — Discord 机器人令牌（或 ${env:DISCORD_TOKEN} 占位符）

• --client <id> — 客户端: claude-desktop, claude-code, cursor 或 generic

• --output <path> — 将片段写入文件（默认: stdout）

• --force — 覆盖现有输出文件

• --gateway — 在生成的配置中启用 Discord 网关

• --json — 用于 CI 的 JSON 输出

当 stdin 为 TTY 且缺少标志时，init 将运行交互式向导。

discord-mcp migrate

从其他 Discord/MCP 设置迁移。退出代码：0（全部映射）、1（部分未映射）、2（错误）。

标志:

• --from <adapter> — 源适配器 ID（不带 --from 运行以列出）

• --source <path> — 源仓库路径（默认: cwd）

• --json — JSON 输出

可用适配器: hubdustry-go-mcp（参考实现）。更多内容见计划 11。

工具界面

涵盖 192 个工具，包括：

• 消息 (12)

• 频道 (14)

• 线程 (6)

• 成员 (14)

• 角色 (5)

• 服务器 (16)

• 审计日志 (1)

• Webhook (13)

• 事件 (6)

• 命令 (15)

• 用户 (6)

• 组件-v2 (8)

• 智能 (5)

• 元数据 (1)

• 反应 (5)

• 表情符号 (5)

• 应用表情符号 (5)

• 贴纸 (7)

• 邀请 (4)

• 自动审核 (5)

• 交互 (8)

• 应用 (5)

• 舞台实例 (4)

• 音板 (7)

• 投票 (2)

• 语音 (3)

• 入门引导 (2)

• 变现 (8)

本地开发

先决条件：Node ≥20.11, pnpm ≥9.15。

pnpm install
pnpm build
pnpm test

冒烟测试 (真实 Discord)

将 DISCORD_TOKEN 设置为来自 https://discord.com/developers/applications 的真实机器人令牌：

export DISCORD_TOKEN="Bot YOUR_TOKEN_HERE"
node packages/mcp-server/dist/cli.js

然后在另一个终端中使用 MCP Inspector：

npx -y @modelcontextprotocol/inspector node packages/mcp-server/dist/cli.js

在 http://localhost:5173 打开 Inspector UI，点击 tools/list，你应该能看到所有 192 个工具。

文档

• 操作：遥测 — OTel 设置

• 操作：弹性 — 调整重试/超时/熔断

• 操作：审计 — 审计接收器 + 合规性

许可证

MIT — 见 LICENSE。