Cloud Discord

云不和谐

在Cloudflare Workers上运行的功能齐全的Discord MCP（模型上下文协议）服务器。为AI代理提供对Discord服务器的完全管理控制——59个工具，涵盖消息传递、审核、论坛、角色、文件、语音笔记等。

部署一次，从任何兼容MCP的客户端（Claude Code、Claude Desktop、Cursor等）连接。

特性

59工具 12个类别：

另外：

• /vibe 斜线命令-AI驱动通道振动检查（需要Anthropic API键）
• 直接文件上传端点——从您的计算机发送文件，无需base64编码
• 秘密路径身份验证——您的MCP端点只能通过您的秘密URL访问
• 自动重试的速率限制处理

先决条件

• A. Cloudflare帐户 （免费版作品）
• 18+
• 具有适当权限的Discord机器人

设置

1.创建Discord Bot

1. 去 Discord开发者门户
2. 点击 新应用，给它起个名字
3. 去 机器人 选项卡：

- 点击 重置令牌 并保存令牌——稍后您将需要它 - 启用 消息内容意图 在特权网关权限下

1. 去 一般信息 选项卡：

- 复制 应用标识符 （你需要这个 /vibe 命令） - 复制 公钥 （你需要这个 wrangler.toml)

1. 首选 OAuth2>URL生成器:

- 选择范围： bot, applications.commands - 选择机器人权限： Administrator （或选择您需要的单个权限） - 复制生成的URL并在浏览器中打开，以邀请机器人到您的服务器

2.克隆和安装

git clone https://github.com/codependentai/cloud-discord.git
cd cloud-discord
npm install

3.配置

编辑 wrangler.toml:

[vars]
# Generate a random secret: openssl rand -base64 24
MCP_SECRET_PATH = "your-random-secret-here"

# From Discord Developer Portal > General Information > Public Key
DISCORD_PUBLIC_KEY = "your-public-key-here"

4.添加秘密

这些数据安全地存储在Cloudflare中，它们永远不会出现在您的代码中：

# Required — your Discord bot token
npx wrangler secret put DISCORD_BOT_TOKEN
# Paste your bot token when prompted

# Optional — needed for the /vibe slash command
npx wrangler secret put ANTHROPIC_API_KEY

# Optional — needed for voice notes (discord_send_voice_note)
npx wrangler secret put ELEVENLABS_API_KEY

5.部署

npx wrangler deploy

您的MCP服务器现在位于：

https://cloud-discord..workers.dev/mcp/

6.连接到您的MCP客户端

将服务器添加到MCP客户端的配置中。例如，在Claude Code的 .mcp.json:

{
  "mcpServers": {
    "discord": {
      "type": "url",
      "url": "https://cloud-discord..workers.dev/mcp/"
    }
  }
}

对于Claude Desktop，请将其添加到 claude_desktop_config.json 在...之下 mcpServers 格式相同。

可选：注册/vibe Slash命令

这 /vibe 该命令允许Discord服务器中的任何人在当前频道上运行AI驱动的氛围检查。它读取最后20条消息并总结正在发生的事情。

需要 ANTHROPIC_API_KEY 待设定。

DISCORD_APP_ID=your_app_id DISCORD_BOT_TOKEN=your_token npx tsx src/register-commands.ts

然后在Discord开发者门户中，设置 交互端点URL 致：

https://cloud-discord..workers.dev/interactions

可选：语音备忘

这 discord_send_voice_note 该工具使用以下命令生成语音 十一实验室 并将其作为音频文件发送到Discord。

1. 注册地址： 十一实验室 并获取API密钥
2. 添加密码： npx wrangler secret put ELEVENLABS_API_KEY
3. 在中查找您的语音ID 语音实验室
4. 使用该工具 voice_id 和 text 参数

如果 ELEVENLABS_API_KEY 如果未设置，该工具在调用时将返回错误，但不会影响任何其他工具。

直接文件上传

要发送没有base64编码的本地文件（图像、音频、文档），请使用直接上传端点：

# Send to a channel
curl -F "channel_id=CHANNEL_ID" \
     -F "file=@/path/to/file.mp3" \
     -F "message=Optional message" \
     https://cloud-discord..workers.dev/mcp//upload

# Send as DM
curl -F "user_id=USER_ID" \
     -F "file=@/path/to/image.png" \
     https://cloud-discord..workers.dev/mcp//upload

当MCP工具的base64参数太大（例如音频文件）时，这很有用。

工具参考

消息传递

节制

角色

频道

线程

论坛

反应和别针

文件和语音

服务器和成员

邀请与投票

图像

建筑

这是一个Cloudflare Worker（约330 KB），它：

1. 在以下位置接收MCP JSON-RPC请求 /mcp/
2. 将工具调用转换为Discord REST API请求
3. 将格式化的结果返回给MCP客户端

没有数据库，没有状态，没有容器。Auth由URL中的秘密路径处理-任何拥有URL的人都可以使用所有工具，因此将其视为API密钥。

这 /vibe slash命令处理以下位置的Discord交互 /interactions 使用签名验证。

发展

# Run locally
npx wrangler dev

# Type check
npx tsc --noEmit

# Deploy
npx wrangler deploy

许可证

麻省理工学院——见 许可证.

由...建造 相互依存的人工智能.

支持

由...建造 相互依存的人工智能.