@kongyo2/discord-webhook-mcp 1.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kongyo2
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 定数定義
+ */
+export declare const CHARACTER_LIMIT = 25000;
+export declare const MAX_CONTENT_LENGTH = 2000;
+export declare const MAX_EMBEDS = 10;
+export declare const MAX_FIELDS = 25;
+export declare const MAX_EMBED_TOTAL_CHARS = 6000;
+export declare const RATE_LIMIT_PER_MINUTE = 30;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AACvC,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,KAAK,CAAC;AAG7B,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAG1C,eAAO,MAAM,qBAAqB,KAAK,CAAC"}

package/dist/constants.js

@@ -0,0 +1,12 @@
+/**
+ * 定数定義
+ */
+export const CHARACTER_LIMIT = 25000;
+export const MAX_CONTENT_LENGTH = 2000;
+export const MAX_EMBEDS = 10;
+export const MAX_FIELDS = 25;
+// Discord API制限: すべてのEmbed合計で6000文字
+export const MAX_EMBED_TOTAL_CHARS = 6000;
+// レート制限: 30メッセージ/分/チャンネル
+export const RATE_LIMIT_PER_MINUTE = 30;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,oCAAoC;AACpC,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C,yBAAyB;AACzB,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC"}

package/dist/discord-api.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Discord Webhook API クライアント
+ */
+import type { DiscordMessageResponse, DiscordWebhookError, Embed, AllowedMentions } from "./types.js";
+export declare function isWebhookError(error: DiscordWebhookError): error is Extract<DiscordWebhookError, {
+    type: "webhook_error";
+}>;
+export declare function formatError(error: DiscordWebhookError): string;
+export declare function sendToDiscord(payload: {
+    content?: string;
+    username?: string;
+    avatar_url?: string;
+    tts?: boolean;
+    embeds?: Embed[];
+    allowed_mentions?: AllowedMentions;
+    thread_name?: string;
+}, wait?: boolean, threadId?: string): Promise<{
+    result: DiscordMessageResponse | null;
+    error?: DiscordWebhookError;
+}>;
+export declare function editDiscordMessage(messageId: string, payload: {
+    content?: string;
+    embeds?: Embed[];
+    allowed_mentions?: AllowedMentions;
+}): Promise<{
+    result: DiscordMessageResponse | null;
+    error?: DiscordWebhookError;
+}>;
+export declare function deleteDiscordMessage(messageId: string): Promise<{
+    error?: DiscordWebhookError;
+}>;
+//# sourceMappingURL=discord-api.d.ts.map

package/dist/discord-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-api.d.ts","sourceRoot":"","sources":["../src/discord-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,EACL,eAAe,EAChB,MAAM,YAAY,CAAC;AAYpB,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,GACzB,KAAK,IAAI,OAAO,CAAC,mBAAmB,EAAE;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC,CAElE;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAe9D;AAgFD,wBAAsB,aAAa,CACjC,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,gBAAgB,CAAC,EAAE,eAAe,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,EACD,IAAI,GAAE,OAAc,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAejF;AAGD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,gBAAgB,CAAC,EAAE,eAAe,CAAC;CACpC,GACA,OAAO,CAAC;IAAE,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC,CASjF;AAGD,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,KAAK,CAAC,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAS1C"}

package/dist/discord-api.js

@@ -0,0 +1,126 @@
+/**
+ * Discord Webhook API クライアント
+ */
+// 環境変数からWebhook URLを取得
+const WEBHOOK_URL = process.env.DISCORD_WEBHOOK_URL;
+if (!WEBHOOK_URL) {
+    process.stderr.write("DISCORD_WEBHOOK_URL environment variable is not set\n");
+    process.stderr.write("Please set DISCORD_WEBHOOK_URL before running this server\n");
+    process.exit(1);
+}
+// 型ガード関数
+export function isWebhookError(error) {
+    return error.type === "webhook_error";
+}
+// エラーメッセージを整形
+export function formatError(error) {
+    switch (error.type) {
+        case "webhook_error":
+            if (error.status === 429) {
+                const retryMsg = error.retryAfter
+                    ? `\n${error.retryAfter}秒後に再試行してください。`
+                    : "\nしばらく待ってから再試行してください。";
+                return `Discord Webhook error: レート制限に達しました (30メッセージ/分/チャンネル)${retryMsg}`;
+            }
+            return `Discord Webhook error: ${error.status} ${error.statusText}\n${error.body}`;
+        case "validation_error":
+            return `Validation error: ${error.field} - ${error.message}`;
+        case "unknown_error":
+            return `Unknown error: ${error.message}`;
+    }
+}
+// APIリクエスト用のヘルパー関数
+async function makeRequest(url, method, body) {
+    const options = {
+        method,
+        headers: { "Content-Type": "application/json" },
+    };
+    if (body) {
+        options.body = JSON.stringify(body);
+    }
+    const response = await fetch(url, options);
+    if (!response.ok) {
+        const errorText = await response.text();
+        const errorInfo = {
+            status: response.status,
+            statusText: response.statusText,
+            body: errorText,
+        };
+        // レート制限の場合、retry-afterヘッダーを取得
+        if (response.status === 429) {
+            const retryAfter = response.headers.get("retry-after");
+            if (retryAfter) {
+                errorInfo.retryAfter = parseInt(retryAfter, 10);
+            }
+        }
+        throw new Error(JSON.stringify(errorInfo));
+    }
+    // DELETE の場合はレスポンスボディがない場合がある
+    if (method === "DELETE") {
+        return undefined;
+    }
+    return response.json();
+}
+// エラーを変換
+function convertError(error) {
+    if (error instanceof Error && error.message.startsWith("{")) {
+        try {
+            const parsed = JSON.parse(error.message);
+            return {
+                type: "webhook_error",
+                status: parsed.status,
+                statusText: parsed.statusText,
+                body: parsed.body,
+                retryAfter: parsed.retryAfter,
+            };
+        }
+        catch {
+            return {
+                type: "unknown_error",
+                message: error.message,
+            };
+        }
+    }
+    return {
+        type: "unknown_error",
+        message: error instanceof Error ? error.message : String(error),
+    };
+}
+// メッセージを送信
+export async function sendToDiscord(payload, wait = true, threadId) {
+    const url = new URL(WEBHOOK_URL);
+    if (wait)
+        url.searchParams.set("wait", "true");
+    if (threadId)
+        url.searchParams.set("thread_id", threadId);
+    try {
+        const result = await makeRequest(url.toString(), "POST", payload);
+        return { result };
+    }
+    catch (error) {
+        return { result: null, error: convertError(error) };
+    }
+}
+// メッセージを編集
+export async function editDiscordMessage(messageId, payload) {
+    const url = new URL(`${WEBHOOK_URL}/messages/${messageId}`);
+    try {
+        const result = await makeRequest(url.toString(), "PATCH", payload);
+        return { result };
+    }
+    catch (error) {
+        return { result: null, error: convertError(error) };
+    }
+}
+// メッセージを削除
+export async function deleteDiscordMessage(messageId) {
+    const url = new URL(`${WEBHOOK_URL}/messages/${messageId}`);
+    try {
+        await makeRequest(url.toString(), "DELETE");
+        return {};
+    }
+    catch (error) {
+        return { error: convertError(error) };
+    }
+}
+//# sourceMappingURL=discord-api.js.map

package/dist/discord-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-api.js","sourceRoot":"","sources":["../src/discord-api.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * Discord Webhook MCP Server
+ *
+ * Discord Webhook を使用してメッセージの送信、編集、削除を行うMCPサーバーです。
+ *
+ * 環境変数:
+ *   - DISCORD_WEBHOOK_URL: Discord Webhook URL (必須)
+ *
+ * 使用例:
+ *   - メッセージ送信: discord_send_message
+ *   - メッセージ編集: discord_edit_message
+ *   - メッセージ削除: discord_delete_message
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}

package/dist/index.js

@@ -0,0 +1,293 @@
+#!/usr/bin/env node
+/**
+ * Discord Webhook MCP Server
+ *
+ * Discord Webhook を使用してメッセージの送信、編集、削除を行うMCPサーバーです。
+ *
+ * 環境変数:
+ *   - DISCORD_WEBHOOK_URL: Discord Webhook URL (必須)
+ *
+ * 使用例:
+ *   - メッセージ送信: discord_send_message
+ *   - メッセージ編集: discord_edit_message
+ *   - メッセージ削除: discord_delete_message
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SendMessageSchema, EditMessageSchema, DeleteMessageSchema, } from "./schemas.js";
+import { sendToDiscord, editDiscordMessage, deleteDiscordMessage, formatError, } from "./discord-api.js";
+// MCPサーバーインスタンスを作成
+const server = new McpServer({
+    name: "discord-webhook-mcp-server",
+    version: "1.0.0",
+});
+// ============ ツール登録 ============
+// メッセージ送信ツール
+server.registerTool("discord_send_message", {
+    title: "Send Discord Message",
+    description: `Discordチャンネルにメッセージを送信します。
+
+content、embedsのいずれか最低1つが必要です。
+環境変数DISCORD_WEBHOOK_URLに設定されたWebhookを使用します。
+
+⚠️ レート制限: 30メッセージ/分/チャンネル
+
+Args:
+  - content (string, optional): メッセージ内容（1-2000文字）
+  - username (string, optional): Webhookのユーザー名を上書き（最大80文字）
+  - avatar_url (string, optional): Webhookのアバター画像をURLで指定
+  - tts (boolean, optional): テキスト読み上げ（TTS）メッセージとして送信（デフォルト: false）
+  - embeds (array, optional): Embedの配列（最大10個、合計6000文字以内）
+  - allowed_mentions (object, optional): 許可されたメンション設定
+  - thread_id (string, optional): 送信先スレッドID（指定したスレッドに送信、スレッドは自動アーカイブ解除）
+  - thread_name (string, optional): 作成するスレッド名（フォーラム/メディアチャンネルのみで新しいスレッドを作成、最大100文字）
+
+Returns:
+  {
+    "success": boolean,        // 送信が成功したか
+    "message_id": string,      // 送信されたメッセージのID
+    "channel_id": string,      // 送信先チャンネルID
+    "timestamp": string        // 送信日時 (ISO 8601形式)
+  }
+
+Examples:
+  - シンプルなテキスト送信: { "content": "Hello, Discord!" }
+  - Embed付き送信: { "embeds": [{ "title": "タイトル", "description": "説明", "color": 0x00FF00 }] }
+  - スレッドに送信: { "content": "スレッドメッセージ", "thread_id": "123456789" }
+
+Error Handling:
+  - "Validation error: content/embeds - content、embeds のうち最低1つを指定してください"
+  - "Discord Webhook error: 400 Bad Request - Invalid webhook URL"
+  - "Discord Webhook error: 404 Not Found - Webhook not found"
+  - "Discord Webhook error: レート制限に達しました" - 429エラー時、retry-after秒後に再試行`,
+    inputSchema: SendMessageSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true,
+    },
+}, async (params) => {
+    // content, embeds のうち1つが必要
+    const hasContent = params.content && params.content.length > 0;
+    const hasEmbeds = params.embeds && params.embeds.length > 0;
+    if (!hasContent && !hasEmbeds) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "エラー: content、embeds のうち最低1つを指定してください",
+                },
+            ],
+            isError: true,
+        };
+    }
+    // payloadの構築
+    const payload = {};
+    if (hasContent)
+        payload.content = params.content;
+    if (params.username)
+        payload.username = params.username;
+    if (params.avatar_url)
+        payload.avatar_url = params.avatar_url;
+    if (params.tts)
+        payload.tts = params.tts;
+    if (hasEmbeds)
+        payload.embeds = params.embeds;
+    if (params.allowed_mentions)
+        payload.allowed_mentions = params.allowed_mentions;
+    if (params.thread_name)
+        payload.thread_name = params.thread_name;
+    // メッセージ送信（wait=trueでメッセージIDを取得）
+    const { result, error } = await sendToDiscord(payload, true, params.thread_id);
+    if (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `エラー: ${formatError(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const messageInfo = result;
+    return {
+        content: [
+            {
+                type: "text",
+                text: messageInfo
+                    ? `メッセージを送信しました\nID: ${messageInfo.id}\nチャンネル: ${messageInfo.channel_id}`
+                    : "メッセージを送信しました",
+            },
+        ],
+        structuredContent: {
+            success: true,
+            message_id: messageInfo?.id,
+            channel_id: messageInfo?.channel_id,
+            timestamp: messageInfo?.timestamp,
+        },
+    };
+});
+// メッセージ編集ツール
+server.registerTool("discord_edit_message", {
+    title: "Edit Discord Message",
+    description: `Webhookで送信したメッセージを編集します。
+
+content、embedsのいずれか最低1つが必要です。
+環境変数DISCORD_WEBHOOK_URLに設定されたWebhookを使用します。
+
+⚠️ レート制限: 30リクエスト/分/チャンネル
+
+Args:
+  - message_id (string, required): 編集するメッセージID
+  - content (string, optional): 新しいメッセージ内容（1-2000文字）
+  - embeds (array, optional): 新しいEmbedの配列（最大10個、合計6000文字以内）
+  - allowed_mentions (object, optional): 許可されたメンション設定
+
+Returns:
+  {
+    "success": boolean,        // 編集が成功したか
+    "message_id": string,      // 編集されたメッセージのID
+    "timestamp": string        // 編集日時 (ISO 8601形式)
+  }
+
+Examples:
+  - テキストを編集: { "message_id": "123456789", "content": "更新後のメッセージ" }
+  - Embedを編集: { "message_id": "123456789", "embeds": [{ "title": "新しいタイトル", "color": 0xFF0000 }] }
+
+Error Handling:
+  - "Validation error: content/embeds - content、embeds のうち最低1つを指定してください"
+  - "Discord Webhook error: 404 Not Found - Message not found"
+  - "Discord Webhook error: 400 Bad Request - Invalid message ID"
+  - "Discord Webhook error: レート制限に達しました" - 429エラー時、retry-after秒後に再試行`,
+    inputSchema: EditMessageSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+}, async (params) => {
+    // content, embeds のうち1つが必要
+    const hasContent = params.content && params.content.length > 0;
+    const hasEmbeds = params.embeds && params.embeds.length > 0;
+    if (!hasContent && !hasEmbeds) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "エラー: content、embeds のうち最低1つを指定してください",
+                },
+            ],
+            isError: true,
+        };
+    }
+    // payloadの構築
+    const payload = {};
+    if (hasContent)
+        payload.content = params.content;
+    if (hasEmbeds)
+        payload.embeds = params.embeds;
+    if (params.allowed_mentions)
+        payload.allowed_mentions = params.allowed_mentions;
+    // メッセージ編集
+    const { result, error } = await editDiscordMessage(params.message_id, payload);
+    if (error || !result) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: error
+                        ? `エラー: ${formatError(error)}`
+                        : "エラー: メッセージの編集に失敗しました",
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `メッセージを編集しました\nID: ${result.id}`,
+            },
+        ],
+        structuredContent: {
+            success: true,
+            message_id: result.id,
+            timestamp: result.timestamp,
+        },
+    };
+});
+// メッセージ削除ツール
+server.registerTool("discord_delete_message", {
+    title: "Delete Discord Message",
+    description: `Webhookで送信したメッセージを削除します。
+
+環境変数DISCORD_WEBHOOK_URLに設定されたWebhookを使用します。
+
+⚠️ レート制限: 30リクエスト/分/チャンネル
+⚠️ この操作は取り消せません。
+
+Args:
+  - message_id (string, required): 削除するメッセージID
+
+Returns:
+  {
+    "success": boolean,        // 削除が成功したか
+    "message_id": string       // 削除されたメッセージのID
+  }
+
+Examples:
+  - メッセージ削除: { "message_id": "123456789" }
+
+Error Handling:
+  - "Discord Webhook error: 404 Not Found - Message not found"
+  - "Discord Webhook error: 400 Bad Request - Invalid message ID"
+  - "Discord Webhook error: レート制限に達しました" - 429エラー時、retry-after秒後に再試行`,
+    inputSchema: DeleteMessageSchema,
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: true,
+    },
+}, async (params) => {
+    // メッセージ削除
+    const { error } = await deleteDiscordMessage(params.message_id);
+    if (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `エラー: ${formatError(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `メッセージを削除しました\nID: ${params.message_id}`,
+            },
+        ],
+        structuredContent: {
+            success: true,
+            message_id: params.message_id,
+        },
+    };
+});
+// ============ サーバー起動 ============
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write("Discord Webhook MCP Server running via stdio\n");
+}
+main().catch((error) => {
+    process.stderr.write(`Fatal error: ${error}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}