Discord Notification MCP

🚀 Discord Notification MCP Server

このサーバーは、Claude Codeがタスクを完了した際にDiscordに通知を送信するMCP（Model Context Protocol）サーバーです。TypeScriptを使用してCloudflare Agents SDKで構築されており、Cloudflare Workers上でデプロイ可能です。

🚀 クイックスタート

このMCPサーバーを使うことで、Claude Codeがタスクを完了したときにDiscordに通知を送信できます。以下のセクションでは、セットアップ、使用方法、開発、デバッグなどの手順を説明します。

✨ 主な機能

• 🤖 MCPツール：通知を送信するためのsend_discord_messageツールを提供します。
• 🚀 Cloudflare Workers：サーバーレスでグローバルに配信できます。
• 🔐 セキュア：Cloudflareのシークレットを使用して資格情報を管理します。
• 🌐 デュアルトランスポート：最大の互換性のためにSSEとStreamable HTTPの両方をサポートします。
• 💾 Durable Objects：McpAgentが必要とする状態管理を提供します。
• 💬 リッチフォーマット：埋め込み、TTSメッセージ、メンションコントロールをサポートします。

📚 ドキュメント

アーキテクチャ

このサーバーは、CloudflareのAgents SDKを使用してMCP仕様を実装しています。

• GET /sse：MCP通信のためのSSEエンドポイントです。
• POST /mcp：MCP通信のためのStreamable HTTPエンドポイントです。
• TypeScript、MCP SDK、Cloudflare Agents SDKを使用して構築されています。
• 適切なJSON - RPC 2.0エラーハンドリングが実装されています。
• 状態付き接続のためのDurable Objects（McpAgentに必要）が使用されています。
• Node.js互換モードが有効になっています。

セットアップ

前提条件

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を使用してClaude CodeにMCPサーバーを追加します（SSEトランスポートを使用）。

# 本番環境のデプロイ（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（Server - Sent Events）とStreamable HTTPトランスポートの両方をサポートしています。SSEは動作が良好ですが、Streamable HTTPはより高い信頼性を提供し、新しい標準です。 設定を確認するには、次のコマンドを実行します。

claude mcp list

💻 使用例

基本的な使用法

設定が完了すると、Claude Codeは必要なときにいつでもDiscordに通知を送信できます。

// シンプルなメッセージ
await send_discord_message({ content: "Task completed!" })

// リッチな埋め込みメッセージ
await send_discord_message({ 
  content: "Status Update",
  embeds: [{
    title: "Build Results",
    description: "All tests passed",
    color: 5025616, // 緑色
    fields: [
      { name: "Tests", value: "52/52", inline: true },
      { name: "Duration", value: "2m 34s", inline: true }
    ]
  }]
})

通知のタイミング

Claude Codeは以下の場合に通知を送信します。

• 明示的に要求した場合（「完了したら通知して」や「Discordに知らせて」など）
• 実行中にエラーが発生した場合
• 重要なマイルストーンに到達した場合
• ユーザーの入力や介入が必要な場合

サンプルシナリオ

# 「本番環境にデプロイし、完了したら通知して」と要求
# 結果: 🤖 Claude Code Notification
#         デプロイが正常に完了しました！アプリが公開されました。

# 「すべてのテストを実行し、結果を教えて」と要求
# 結果: 🤖 Claude Code Notification
#         すべてのテストが合格しました！52/52のテストが成功しました。

# 「このデータを処理し、エラーがあれば通知して」と要求
# 結果: 🤖 Claude Code Notification
#         エラー: 行451の処理に失敗しました - 無効な日付形式

CLAUDE.mdの例

Claude CodeがDiscord通知を効果的に使用するように促すには、CLAUDE.mdに以下を追加します。

# Discord通知

mcp__discord - notify__send_discord_messageツールを使用して、Discordに通知を送信します。

- 常に以下の場合にDiscord通知を送信します。
  - タスクが完全に完了したとき
  - 続行するためにユーザーの入力が必要なとき
  - ユーザーの注意が必要なエラーが発生したとき
  - ユーザーが明示的に通知を要求したとき（例：「通知して」、「メッセージを送って」、「知らせて」）

- 通知に関連する詳細を含めます。
  - ビルド/テストの場合：成功/失敗のステータスと件数
  - エラーの場合：具体的なエラーメッセージとファイルの場所

- 以下のような簡潔で有益なメッセージを使用します。
  - "✅ ビルドが正常に完了しました（2m 34s）"
  - "❌ テストが失敗しました：auth.test.tsで3/52が失敗しました"
  - "⚠️ /etc/hostsを変更するための権限が必要です"

🔧 開発

ローカルでの実行

# ローカル開発サーバーを起動
pnpm dev

ローカル開発では、Wranglerが自動的に.dev.varsファイルから環境変数を読み込みます。

デプロイ前のチェック

pnpm build

このコマンドは以下を実行します。

1. pnpm format - Biomeでコードを整形します。
2. pnpm lint:fix - リントエラーを修正します。
3. pnpm cf - typegen - Cloudflareの型を生成します。
4. pnpm type - check - TypeScriptの型をチェックします。

サーバーのテスト

# SSE接続をテスト
curl http://localhost:8787/sse

# ヘルスエンドポイントをテスト
curl http://localhost:8787/

🔧 技術詳細

• 言語：TypeScript（ES2021ターゲット）
• ランタイム：Node.js互換のCloudflare Workers
• プロトコル：MCP（Model Context Protocol）
• トランスポート：SSEとStreamable HTTP
• 状態管理：Durable Objects（McpAgentに必要）
• 監視：監視のために有効になっています。

🔍 参照

このプロジェクトは以下のガイドに沿って構築されています。

• Build a Remote MCP server - Cloudflare Agents
• Model Context Protocol (MCP) - Cloudflare Agents
• MCP Transport Methods - Cloudflare Agents
• Cloudflare MCP Template (remote - mcp - authless)

📚 関連プロジェクト

• Telegram Notification MCP - DiscordではなくTelegramに通知を送信します。

📄 ライセンス

MITライセンスの下で公開されています。