@quadslab.io/discord-mcp 1.0.0

package/dist/tools/stage.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Stage instance management tools
+ */
+export declare const stageTools: Tool[];
+export declare function executeStageTool(name: string, args: Record<string, unknown>): Promise<string>;

package/dist/tools/stage.js

@@ -0,0 +1,153 @@
+import { getGuild } from '../discord-client.js';
+import { smartFindChannel } from './utils.js';
+import { ChannelType, StageInstancePrivacyLevel } from 'discord.js';
+/**
+ * Stage instance management tools
+ */
+export const stageTools = [
+    {
+        name: 'list_stage_instances',
+        description: 'List all active stage instances in the Discord server. Returns details including topic, channel, and privacy level.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'start_stage',
+        description: 'Start a new stage instance on a stage channel. Requires specifying a stage voice channel and a topic.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                channel: {
+                    type: 'string',
+                    description: 'The stage channel name or ID (fuzzy matched)',
+                },
+                topic: {
+                    type: 'string',
+                    description: 'The topic for the stage instance',
+                },
+                sendNotification: {
+                    type: 'boolean',
+                    description: 'Whether to send a start notification to the server (default: false)',
+                },
+            },
+            required: ['channel', 'topic'],
+        },
+    },
+    {
+        name: 'end_stage',
+        description: 'End an active stage instance on a stage channel.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                channel: {
+                    type: 'string',
+                    description: 'The stage channel name or ID (fuzzy matched)',
+                },
+            },
+            required: ['channel'],
+        },
+    },
+];
+export async function executeStageTool(name, args) {
+    switch (name) {
+        case 'list_stage_instances':
+            return await listStageInstances();
+        case 'start_stage':
+            return await startStage(args);
+        case 'end_stage':
+            return await endStage(args);
+        default:
+            throw new Error(`Unknown stage tool: ${name}`);
+    }
+}
+function mapPrivacyLevelToString(level) {
+    switch (level) {
+        case StageInstancePrivacyLevel.GuildOnly:
+            return 'guild_only';
+        default:
+            return 'unknown';
+    }
+}
+async function listStageInstances() {
+    const guild = await getGuild();
+    const fetched = await guild.stageInstances.fetch({});
+    // Handle both Collection and array-like returns
+    const instances = fetched instanceof Map ? Array.from(fetched.values()) : Array.isArray(fetched) ? fetched : [fetched].filter(Boolean);
+    const result = instances.map(instance => {
+        const channel = guild.channels.cache.get(instance.channelId);
+        return {
+            id: instance.id,
+            topic: instance.topic,
+            channelId: instance.channelId,
+            channelName: channel?.name ?? null,
+            privacyLevel: mapPrivacyLevelToString(instance.privacyLevel),
+            discoverableDisabled: instance.discoverableDisabled,
+        };
+    });
+    return JSON.stringify(result, null, 2);
+}
+async function startStage(args) {
+    const guild = await getGuild();
+    const channelQuery = args['channel'];
+    const topic = args['topic'];
+    const sendNotification = args['sendNotification'] ?? false;
+    const channel = await smartFindChannel(channelQuery);
+    if (channel.type !== ChannelType.GuildStageVoice) {
+        throw new Error(`Channel "${channel.name}" is not a stage channel. It must be a stage voice channel.`);
+    }
+    try {
+        const stageInstance = await guild.stageInstances.create(channel.id, {
+            topic,
+            privacyLevel: StageInstancePrivacyLevel.GuildOnly,
+            sendStartNotification: sendNotification,
+        });
+        const resolvedChannel = guild.channels.cache.get(stageInstance.channelId);
+        return JSON.stringify({
+            success: true,
+            message: `Stage instance started with topic "${stageInstance.topic}"`,
+            stageInstance: {
+                id: stageInstance.id,
+                topic: stageInstance.topic,
+                channelId: stageInstance.channelId,
+                channelName: resolvedChannel?.name ?? null,
+                privacyLevel: mapPrivacyLevelToString(stageInstance.privacyLevel),
+                discoverableDisabled: stageInstance.discoverableDisabled,
+            },
+        }, null, 2);
+    }
+    catch (error) {
+        throw new Error(`Failed to start stage instance: ${error.message}`);
+    }
+}
+async function endStage(args) {
+    const guild = await getGuild();
+    const channelQuery = args['channel'];
+    const channel = await smartFindChannel(channelQuery);
+    if (channel.type !== ChannelType.GuildStageVoice) {
+        throw new Error(`Channel "${channel.name}" is not a stage channel.`);
+    }
+    const stageChannel = channel;
+    let stageInstance = stageChannel.stageInstance;
+    if (!stageInstance) {
+        // Try fetching from guild stage instances
+        try {
+            stageInstance = await guild.stageInstances.fetch(channel.id);
+        }
+        catch {
+            throw new Error(`No active stage instance found on channel "${channel.name}".`);
+        }
+    }
+    if (!stageInstance) {
+        throw new Error(`No active stage instance found on channel "${channel.name}".`);
+    }
+    const topic = stageInstance.topic;
+    await guild.stageInstances.delete(channel.id);
+    return JSON.stringify({
+        success: true,
+        message: `Stage instance with topic "${topic}" ended successfully on channel "${channel.name}"`,
+    }, null, 2);
+}
+//# sourceMappingURL=stage.js.map

package/dist/tools/stage.js.map

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

package/dist/tools/threads.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Thread management tools
+ */
+export declare const threadTools: Tool[];
+export declare function executeThreadTool(name: string, args: Record<string, unknown>): Promise<string>;

package/dist/tools/threads.js

@@ -0,0 +1,331 @@
+import { getGuild } from '../discord-client.js';
+import { smartFindTextChannel } from './utils.js';
+import { ChannelType } from 'discord.js';
+/**
+ * Thread management tools
+ */
+export const threadTools = [
+    {
+        name: 'list_threads',
+        description: 'List active threads in the Discord server. Optionally filter to a specific channel (fuzzy-matched).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                channel: {
+                    type: 'string',
+                    description: 'Channel name or ID to filter threads to (fuzzy matched, optional)',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'create_thread',
+        description: 'Create a new thread in a channel. Channel name is fuzzy-matched. Can create a thread from an existing message or a standalone thread.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                channel: {
+                    type: 'string',
+                    description: 'The channel name or ID to create the thread in (fuzzy matched)',
+                },
+                name: {
+                    type: 'string',
+                    description: 'The name for the new thread',
+                },
+                messageId: {
+                    type: 'string',
+                    description: 'The ID of a message to start the thread from (optional — creates a standalone thread if omitted)',
+                },
+                autoArchiveDuration: {
+                    type: 'number',
+                    description: 'Auto-archive duration in minutes: 60, 1440 (1 day), 4320 (3 days), or 10080 (7 days)',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'The reason for creating this thread (shown in audit log)',
+                },
+            },
+            required: ['channel', 'name'],
+        },
+    },
+    {
+        name: 'archive_thread',
+        description: 'Archive a thread by name or ID. Optionally specify the parent channel to help find the thread.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                thread: {
+                    type: 'string',
+                    description: 'The thread name or ID to archive',
+                },
+                channel: {
+                    type: 'string',
+                    description: 'The parent channel name or ID to help find the thread (fuzzy matched, optional)',
+                },
+            },
+            required: ['thread'],
+        },
+    },
+    {
+        name: 'unarchive_thread',
+        description: 'Unarchive a thread by name or ID. Optionally specify the parent channel to help find the thread.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                thread: {
+                    type: 'string',
+                    description: 'The thread name or ID to unarchive',
+                },
+                channel: {
+                    type: 'string',
+                    description: 'The parent channel name or ID to help find the thread (fuzzy matched, optional)',
+                },
+            },
+            required: ['thread'],
+        },
+    },
+    {
+        name: 'delete_thread',
+        description: 'Delete a thread by name or ID.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                thread: {
+                    type: 'string',
+                    description: 'The thread name or ID to delete',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'The reason for deleting this thread (shown in audit log)',
+                },
+            },
+            required: ['thread'],
+        },
+    },
+    {
+        name: 'lock_thread',
+        description: 'Lock a thread to prevent new messages.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                thread: {
+                    type: 'string',
+                    description: 'The thread name or ID to lock',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'The reason for locking this thread (shown in audit log)',
+                },
+            },
+            required: ['thread'],
+        },
+    },
+    {
+        name: 'unlock_thread',
+        description: 'Unlock a thread to allow new messages.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                thread: {
+                    type: 'string',
+                    description: 'The thread name or ID to unlock',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'The reason for unlocking this thread (shown in audit log)',
+                },
+            },
+            required: ['thread'],
+        },
+    },
+];
+export async function executeThreadTool(name, args) {
+    switch (name) {
+        case 'list_threads':
+            return await listThreads(args);
+        case 'create_thread':
+            return await createThread(args);
+        case 'archive_thread':
+            return await archiveThread(args);
+        case 'unarchive_thread':
+            return await unarchiveThread(args);
+        case 'delete_thread':
+            return await deleteThread(args);
+        case 'lock_thread':
+            return await lockThread(args);
+        case 'unlock_thread':
+            return await unlockThread(args);
+        default:
+            throw new Error(`Unknown thread tool: ${name}`);
+    }
+}
+/**
+ * Find a thread by name or ID from the guild's active threads
+ */
+async function findThread(identifier) {
+    const guild = await getGuild();
+    // Try exact ID match from guild channels cache
+    const cachedChannel = guild.channels.cache.get(identifier);
+    if (cachedChannel && cachedChannel.isThread()) {
+        return cachedChannel;
+    }
+    // Fetch active threads and try matching
+    const activeThreads = await guild.channels.fetchActiveThreads();
+    // Try exact ID match from active threads
+    const idMatch = activeThreads.threads.get(identifier);
+    if (idMatch) {
+        return idMatch;
+    }
+    // Try name match (case-insensitive)
+    const identifierLower = identifier.toLowerCase();
+    const nameMatch = activeThreads.threads.find(t => t.name.toLowerCase() === identifierLower);
+    if (nameMatch) {
+        return nameMatch;
+    }
+    // Try partial name match (case-insensitive)
+    const partialMatch = activeThreads.threads.find(t => t.name.toLowerCase().includes(identifierLower) || identifierLower.includes(t.name.toLowerCase()));
+    if (partialMatch) {
+        return partialMatch;
+    }
+    // Not found — provide helpful error
+    const threadNames = activeThreads.threads.map(t => t.name);
+    let errorMsg = `Thread "${identifier}" not found.`;
+    if (threadNames.length > 0) {
+        errorMsg += ` Active threads: ${threadNames.join(', ')}`;
+    }
+    else {
+        errorMsg += ' No active threads found in this server.';
+    }
+    throw new Error(errorMsg);
+}
+function formatThread(thread) {
+    return {
+        name: thread.name,
+        id: thread.id,
+        parentChannel: thread.parent
+            ? { name: thread.parent.name, id: thread.parent.id }
+            : null,
+        messageCount: thread.messageCount ?? null,
+        memberCount: thread.memberCount ?? null,
+        archived: thread.archived ?? false,
+        locked: thread.locked ?? false,
+        createdAt: thread.createdAt?.toISOString() ?? null,
+        archiveTimestamp: thread.archiveTimestamp
+            ? new Date(thread.archiveTimestamp).toISOString()
+            : null,
+    };
+}
+async function listThreads(args) {
+    const guild = await getGuild();
+    const channelIdentifier = args['channel'];
+    if (channelIdentifier) {
+        // Filter to a specific channel
+        const channel = await smartFindTextChannel(channelIdentifier);
+        const activeThreads = await guild.channels.fetchActiveThreads();
+        const channelThreads = activeThreads.threads.filter(t => t.parentId === channel.id);
+        const threads = channelThreads.map(t => formatThread(t));
+        return JSON.stringify({
+            channel: { name: channel.name, id: channel.id },
+            threadCount: threads.length,
+            threads,
+        }, null, 2);
+    }
+    // List all active threads
+    const activeThreads = await guild.channels.fetchActiveThreads();
+    const threads = activeThreads.threads.map(t => formatThread(t));
+    return JSON.stringify({
+        threadCount: threads.length,
+        threads,
+    }, null, 2);
+}
+async function createThread(args) {
+    const channelIdentifier = args['channel'];
+    const name = args['name'];
+    const messageId = args['messageId'];
+    const autoArchiveDuration = args['autoArchiveDuration'];
+    const reason = args['reason'];
+    const channel = await smartFindTextChannel(channelIdentifier);
+    // Ensure the channel supports threads (must be a text-based channel with threads)
+    if (!('threads' in channel)) {
+        throw new Error(`Channel "#${channel.name}" does not support threads.`);
+    }
+    let thread;
+    if (messageId) {
+        // Create thread from a message
+        thread = await channel.threads.create({
+            startMessage: messageId,
+            name,
+            autoArchiveDuration: autoArchiveDuration,
+            reason: reason ?? 'Created via MCP',
+        });
+    }
+    else {
+        // Create standalone thread
+        thread = await channel.threads.create({
+            name,
+            autoArchiveDuration: autoArchiveDuration,
+            type: ChannelType.PublicThread,
+            reason: reason ?? 'Created via MCP',
+        });
+    }
+    return JSON.stringify({
+        success: true,
+        message: `Thread "${thread.name}" created successfully in #${channel.name}`,
+        thread: formatThread(thread),
+    }, null, 2);
+}
+async function archiveThread(args) {
+    const threadIdentifier = args['thread'];
+    const thread = await findThread(threadIdentifier);
+    await thread.setArchived(true);
+    return JSON.stringify({
+        success: true,
+        message: `Thread "${thread.name}" archived successfully`,
+        thread: formatThread(thread),
+    }, null, 2);
+}
+async function unarchiveThread(args) {
+    const threadIdentifier = args['thread'];
+    const thread = await findThread(threadIdentifier);
+    await thread.setArchived(false);
+    return JSON.stringify({
+        success: true,
+        message: `Thread "${thread.name}" unarchived successfully`,
+        thread: formatThread(thread),
+    }, null, 2);
+}
+async function deleteThread(args) {
+    const threadIdentifier = args['thread'];
+    const reason = args['reason'];
+    const thread = await findThread(threadIdentifier);
+    const threadName = thread.name;
+    await thread.delete(reason);
+    return JSON.stringify({
+        success: true,
+        message: `Thread "${threadName}" deleted successfully`,
+    }, null, 2);
+}
+async function lockThread(args) {
+    const threadIdentifier = args['thread'];
+    const reason = args['reason'];
+    const thread = await findThread(threadIdentifier);
+    await thread.setLocked(true, reason);
+    return JSON.stringify({
+        success: true,
+        message: `Thread "${thread.name}" locked successfully`,
+        thread: formatThread(thread),
+    }, null, 2);
+}
+async function unlockThread(args) {
+    const threadIdentifier = args['thread'];
+    const reason = args['reason'];
+    const thread = await findThread(threadIdentifier);
+    await thread.setLocked(false, reason);
+    return JSON.stringify({
+        success: true,
+        message: `Thread "${thread.name}" unlocked successfully`,
+        thread: formatThread(thread),
+    }, null, 2);
+}
+//# sourceMappingURL=threads.js.map

package/dist/tools/threads.js.map

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

package/dist/tools/utils.d.ts

@@ -0,0 +1,21 @@
+import { CategoryChannel, GuildChannel, Role, GuildMember, GuildTextBasedChannel } from 'discord.js';
+/**
+ * Smart find a channel that can receive messages - includes text channels, announcement channels, and voice channel text chats
+ */
+export declare function smartFindTextChannel(identifier: string): Promise<GuildTextBasedChannel>;
+/**
+ * Smart find any channel (text, voice, category) - uses cached data
+ */
+export declare function smartFindChannel(identifier: string): Promise<GuildChannel>;
+/**
+ * Smart find category channel - uses cached data
+ */
+export declare function smartFindCategory(identifier: string): Promise<CategoryChannel>;
+/**
+ * Smart find role - uses cached data and fuzzy matching
+ */
+export declare function smartFindRole(identifier: string): Promise<Role>;
+/**
+ * Smart find member - uses cached data and fuzzy matching
+ */
+export declare function smartFindMember(identifier: string): Promise<GuildMember>;