Discord Notification MCP

🚀 Discord通知MCP服務器

這是一個MCP（模型上下文協議）服務器，當Claude Code完成任務時，它會向Discord發送通知。該服務器使用TypeScript和Cloudflare Agents SDK構建，可部署在Cloudflare Workers上。

🚀 快速開始

本服務器可在Claude Code完成任務時向Discord發送通知。以下是使用該服務器的快速步驟：

1. 完成前置準備（創建Discord Webhook、註冊Cloudflare賬戶）
2. 安裝依賴
3. 配置環境變量和Cloudflare密鑰
4. 部署到Cloudflare Workers
5. 配置Claude Code以使用該服務器

✨ 主要特性

• 🤖 MCP工具：提供send_discord_message工具用於發送通知。
• 🚀 Cloudflare Workers：無服務器運行，具備全球分發能力。
• 🔐 安全可靠：使用Cloudflare密鑰存儲憑證。
• 🌐 雙傳輸協議：支持SSE和可流式HTTP，以實現最大兼容性。
• 💾 持久對象：提供McpAgent所需的狀態管理。
• 💬 豐富格式：支持嵌入內容、TTS消息和提及控制。

📦 安裝指南

前置要求

1. Discord Webhook：在Discord頻道中創建一個Webhook：
   • 右鍵點擊頻道 → 編輯頻道 → 集成 → Webhook
   • 點擊“新建Webhook”並複製Webhook URL
2. Cloudflare賬戶：在cloudflare.com註冊賬戶。

安裝步驟

1. 克隆此倉庫。
2. 安裝依賴：

pnpm install

配置

1. 從示例文件創建.dev.vars文件：

cp .dev.vars.example .dev.vars

然後在.dev.vars中編輯你的Webhook URL。此文件用於本地開發和部署。

2. 對於生產部署，設置Cloudflare密鑰：

npx wrangler secret put WEBHOOK_URL

3. 如有需要，在wrangler.toml中更新你的工作器名稱。

部署

部署到Cloudflare Workers：

# 首先設置密鑰
npx wrangler secret put WEBHOOK_URL

# 然後部署
pnpm run deploy

替代方案：持續部署 你也可以直接從Cloudflare控制檯設置持續部署。瞭解更多關於Cloudflare的Git集成。

Claude Code配置

使用CLI通過SSE傳輸將MCP服務器添加到Claude Code：

# 對於生產部署（SSE）
claude mcp add discord-notify https://your-worker-name.workers.dev/sse -t sse

# 對於本地開發
claude mcp add discord-notify http://localhost:8787/sse -t sse

注意：此服務器支持SSE（服務器發送事件）和可流式HTTP傳輸。雖然SSE運行良好，但可流式HTTP提供更好的可靠性，是較新的標準。

你可以使用以下命令驗證配置：

claude mcp list

💻 使用示例

基礎用法

一旦配置完成，Claude Code可以在你需要時向Discord發送通知。

send_discord_message工具

該工具用於向Discord發送通知消息，參數如下：

• content（必需）：要發送的消息內容。
• tts（可選）：是否以文本轉語音消息發送。
• embeds（可選）：用於豐富格式的嵌入對象數組。
• allowed_mentions（可選）：控制解析哪些提及。

示例代碼：

// 簡單消息
await send_discord_message({ content: "任務完成！" })

// 豐富嵌入消息
await send_discord_message({ 
  content: "狀態更新",
  embeds: [{
    title: "構建結果",
    description: "所有測試通過",
    color: 5025616, // 綠色
    fields: [
      { name: "測試", value: "52/52", inline: true },
      { name: "時長", value: "2分34秒", inline: true }
    ]
  }]
})

高級用法

觸發通知的場景

Claude Code在以下情況下發送通知：

• 你明確要求：“完成後通知我”或“在Discord上告知我”。
• 執行過程中出現錯誤。
• 達到重要里程碑。
• 需要用戶輸入或干預。

示例場景

# 你說：“部署到生產環境並在完成後通知我”
# 結果：🤖 Claude Code通知
#         部署成功完成！應用現已上線。

# 你說：“運行所有測試並告知我結果”
# 結果：🤖 Claude Code通知
#         所有測試通過！52/52個測試成功。

# 你說：“處理此數據並在有任何錯誤時通知我”
# 結果：🤖 Claude Code通知
#         錯誤：處理第451行失敗 - 無效的日期格式

CLAUDE.md示例

為了鼓勵Claude Code有效使用Discord通知，將以下內容添加到你的CLAUDE.md中：

# Discord通知

使用mcp__discord-notify__send_discord_message工具向Discord發送通知。

- 以下情況始終發送Discord通知：
  - 任務完全完成
  - 需要用戶輸入才能繼續
  - 出現需要用戶關注的錯誤
  - 用戶明確要求通知（例如，“通知我”、“給我發消息”、“告知我”）

- 在通知中包含相關詳細信息：
  - 對於構建/測試：成功/失敗狀態和數量
  - 對於錯誤：具體錯誤消息和文件位置

- 使用簡潔、信息豐富的消息，例如：
  - "✅ 構建成功完成（2分34秒）"
  - "❌ 測試失敗：3/52個測試在auth.test.ts中失敗"
  - "⚠️ 需要權限修改 /etc/hosts"

📚 詳細文檔

開發

本地運行

# 啟動本地開發服務器
pnpm dev

對於本地開發，Wrangler將自動從你的.dev.vars文件加載環境變量。

部署前檢查

pnpm build

此命令將執行以下操作：

1. pnpm format - 使用Biome格式化代碼。
2. pnpm lint:fix - 修復 linting 問題。
3. pnpm cf-typegen - 生成Cloudflare類型。
4. pnpm type-check - 檢查TypeScript類型。

測試服務器

# 測試SSE連接
curl http://localhost:8787/sse

# 測試健康端點
curl http://localhost:8787/

調試

測試SSE連接

你可以直接測試SSE端點：

curl -N http://localhost:8787/sse

這應該返回一個以endpoint事件開頭的事件流。

常見問題

1. 連接立即關閉：檢查你的工作器是否正在運行，並可通過指定的URL訪問。
2. 未收到endpoint事件：確保SSE頭正確發送，並且流格式正確。
3. Discord通知未發送：驗證你的WEBHOOK_URL是否在工作器環境中正確設置。

🔧 技術細節

參考資料

本項目根據以下指南構建：

• 構建遠程MCP服務器 - Cloudflare Agents
• 模型上下文協議（MCP） - Cloudflare Agents
• MCP傳輸方法 - Cloudflare Agents
• Cloudflare MCP模板（remote-mcp-authless）

相關項目

• Telegram Notification MCP - 向Telegram而不是Discord發送通知

📄 許可證

本項目採用MIT許可證。