@mahesvara/discord-mcpserver 1.0.7 → 1.0.9

package/dist/schemas/moderation.js

@@ -0,0 +1,152 @@
+import { z } from "zod";
+import { GuildIdSchema, UserIdSchema, ChannelIdSchema, RoleIdSchema, AutoModRuleIdSchema, ResponseFormatSchema } from "./common.js";
+export const KickMemberSchema = z.object({
+    guild_id: GuildIdSchema,
+    user_id: UserIdSchema,
+    reason: z.string()
+        .max(512)
+        .optional()
+        .describe("Reason for kick (visible in audit log)")
+}).strict();
+export const BanMemberSchema = z.object({
+    guild_id: GuildIdSchema,
+    user_id: UserIdSchema,
+    reason: z.string()
+        .max(512)
+        .optional()
+        .describe("Reason for ban (visible in audit log)"),
+    delete_message_days: z.number()
+        .int()
+        .min(0)
+        .max(7)
+        .optional()
+        .describe("Number of days of messages to delete (0-7)")
+}).strict();
+export const UnbanMemberSchema = z.object({
+    guild_id: GuildIdSchema,
+    user_id: UserIdSchema
+}).strict();
+export const TimeoutMemberSchema = z.object({
+    guild_id: GuildIdSchema,
+    user_id: UserIdSchema,
+    duration_minutes: z.number()
+        .int()
+        .min(1)
+        .max(40320)
+        .describe("Timeout duration in minutes (max 28 days = 40320)"),
+    reason: z.string()
+        .max(512)
+        .optional()
+        .describe("Reason for timeout")
+}).strict();
+export const ListBansSchema = z.object({
+    guild_id: GuildIdSchema,
+    limit: z.number()
+        .int()
+        .min(1)
+        .max(1000)
+        .default(100)
+        .describe("Number of bans to return (1-1000)"),
+    response_format: ResponseFormatSchema
+}).strict();
+export const PruneMembersSchema = z.object({
+    guild_id: GuildIdSchema,
+    days: z.number()
+        .int()
+        .min(1)
+        .max(30)
+        .describe("Number of days of inactivity (1-30)"),
+    include_roles: z.array(RoleIdSchema)
+        .optional()
+        .describe("Role IDs to include in prune (normally members with roles are excluded)"),
+    dry_run: z.boolean()
+        .default(true)
+        .describe("If true, only returns count without actually pruning")
+}).strict();
+export const GetAuditLogSchema = z.object({
+    guild_id: GuildIdSchema,
+    limit: z.number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe("Number of entries to retrieve"),
+    user_id: UserIdSchema.optional()
+        .describe("Filter by user who performed actions"),
+    action_type: z.number()
+        .int()
+        .optional()
+        .describe("Filter by action type (Discord audit log action type number)"),
+    response_format: ResponseFormatSchema
+}).strict();
+// Auto Moderation schemas
+export const ListAutoModRulesSchema = z.object({
+    guild_id: GuildIdSchema,
+    response_format: ResponseFormatSchema
+}).strict();
+export const GetAutoModRuleSchema = z.object({
+    guild_id: GuildIdSchema,
+    rule_id: AutoModRuleIdSchema,
+    response_format: ResponseFormatSchema
+}).strict();
+export const CreateAutoModRuleSchema = z.object({
+    guild_id: GuildIdSchema,
+    name: z.string()
+        .min(1)
+        .max(100)
+        .describe("Rule name"),
+    event_type: z.enum(["message_send"])
+        .describe("Event type that triggers the rule"),
+    trigger_type: z.enum(["keyword", "spam", "keyword_preset", "mention_spam"])
+        .describe("Type of content that triggers the rule"),
+    trigger_metadata: z.object({
+        keyword_filter: z.array(z.string()).optional().describe("Keywords to filter (for keyword trigger)"),
+        regex_patterns: z.array(z.string()).optional().describe("Regex patterns to match"),
+        presets: z.array(z.enum(["profanity", "sexual_content", "slurs"])).optional().describe("Preset keyword lists"),
+        allow_list: z.array(z.string()).optional().describe("Allowed keywords that won't trigger"),
+        mention_total_limit: z.number().int().min(1).optional().describe("Max mentions allowed (for mention_spam)")
+    }).optional().describe("Trigger configuration"),
+    actions: z.array(z.object({
+        type: z.enum(["block_message", "send_alert_message", "timeout"]),
+        metadata: z.object({
+            channel_id: ChannelIdSchema.optional().describe("Channel to send alert (for send_alert_message)"),
+            duration_seconds: z.number().int().max(2419200).optional().describe("Timeout duration in seconds (max 28 days)")
+        }).optional()
+    })).describe("Actions to take when rule is triggered"),
+    enabled: z.boolean()
+        .default(true)
+        .describe("Whether the rule is enabled"),
+    exempt_roles: z.array(RoleIdSchema)
+        .optional()
+        .describe("Roles exempt from this rule"),
+    exempt_channels: z.array(ChannelIdSchema)
+        .optional()
+        .describe("Channels exempt from this rule")
+}).strict();
+export const EditAutoModRuleSchema = z.object({
+    guild_id: GuildIdSchema,
+    rule_id: AutoModRuleIdSchema,
+    name: z.string().min(1).max(100).optional(),
+    event_type: z.enum(["message_send"]).optional(),
+    trigger_metadata: z.object({
+        keyword_filter: z.array(z.string()).optional(),
+        regex_patterns: z.array(z.string()).optional(),
+        presets: z.array(z.enum(["profanity", "sexual_content", "slurs"])).optional(),
+        allow_list: z.array(z.string()).optional(),
+        mention_total_limit: z.number().int().min(1).optional()
+    }).optional(),
+    actions: z.array(z.object({
+        type: z.enum(["block_message", "send_alert_message", "timeout"]),
+        metadata: z.object({
+            channel_id: ChannelIdSchema.optional(),
+            duration_seconds: z.number().int().max(2419200).optional()
+        }).optional()
+    })).optional(),
+    enabled: z.boolean().optional(),
+    exempt_roles: z.array(RoleIdSchema).optional(),
+    exempt_channels: z.array(ChannelIdSchema).optional()
+}).strict();
+export const DeleteAutoModRuleSchema = z.object({
+    guild_id: GuildIdSchema,
+    rule_id: AutoModRuleIdSchema
+}).strict();

package/dist/schemas/role.d.ts

@@ -0,0 +1,126 @@
+import { z } from "zod";
+export declare const ListRolesSchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: import("../types.js").ResponseFormat;
+    guild_id: string;
+}, {
+    guild_id: string;
+    response_format?: import("../types.js").ResponseFormat | undefined;
+}>;
+export declare const AddRoleSchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    user_id: z.ZodString;
+    role_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    guild_id: string;
+    user_id: string;
+    role_id: string;
+}, {
+    guild_id: string;
+    user_id: string;
+    role_id: string;
+}>;
+export declare const RemoveRoleSchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    user_id: z.ZodString;
+    role_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    guild_id: string;
+    user_id: string;
+    role_id: string;
+}, {
+    guild_id: string;
+    user_id: string;
+    role_id: string;
+}>;
+export declare const CreateRoleSchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    name: z.ZodString;
+    color: z.ZodOptional<z.ZodNumber>;
+    hoist: z.ZodOptional<z.ZodBoolean>;
+    mentionable: z.ZodOptional<z.ZodBoolean>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    guild_id: string;
+    color?: number | undefined;
+    hoist?: boolean | undefined;
+    mentionable?: boolean | undefined;
+    permissions?: string[] | undefined;
+}, {
+    name: string;
+    guild_id: string;
+    color?: number | undefined;
+    hoist?: boolean | undefined;
+    mentionable?: boolean | undefined;
+    permissions?: string[] | undefined;
+}>;
+export declare const DeleteRoleSchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    role_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    guild_id: string;
+    role_id: string;
+}, {
+    guild_id: string;
+    role_id: string;
+}>;
+export declare const EditRoleSchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    role_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodNumber>;
+    hoist: z.ZodOptional<z.ZodBoolean>;
+    mentionable: z.ZodOptional<z.ZodBoolean>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    guild_id: string;
+    role_id: string;
+    name?: string | undefined;
+    color?: number | undefined;
+    hoist?: boolean | undefined;
+    mentionable?: boolean | undefined;
+    permissions?: string[] | undefined;
+}, {
+    guild_id: string;
+    role_id: string;
+    name?: string | undefined;
+    color?: number | undefined;
+    hoist?: boolean | undefined;
+    mentionable?: boolean | undefined;
+    permissions?: string[] | undefined;
+}>;
+export declare const SetRolePositionsSchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    positions: z.ZodArray<z.ZodObject<{
+        role_id: z.ZodString;
+        position: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        position: number;
+        role_id: string;
+    }, {
+        position: number;
+        role_id: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    guild_id: string;
+    positions: {
+        position: number;
+        role_id: string;
+    }[];
+}, {
+    guild_id: string;
+    positions: {
+        position: number;
+        role_id: string;
+    }[];
+}>;
+export type ListRolesInput = z.infer<typeof ListRolesSchema>;
+export type AddRoleInput = z.infer<typeof AddRoleSchema>;
+export type RemoveRoleInput = z.infer<typeof RemoveRoleSchema>;
+export type CreateRoleInput = z.infer<typeof CreateRoleSchema>;
+export type DeleteRoleInput = z.infer<typeof DeleteRoleSchema>;
+export type EditRoleInput = z.infer<typeof EditRoleSchema>;
+export type SetRolePositionsInput = z.infer<typeof SetRolePositionsSchema>;

package/dist/schemas/role.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { GuildIdSchema, UserIdSchema, RoleIdSchema, ResponseFormatSchema } from "./common.js";
+export const ListRolesSchema = z.object({
+    guild_id: GuildIdSchema,
+    response_format: ResponseFormatSchema
+}).strict();
+export const AddRoleSchema = z.object({
+    guild_id: GuildIdSchema,
+    user_id: UserIdSchema,
+    role_id: RoleIdSchema
+}).strict();
+export const RemoveRoleSchema = z.object({
+    guild_id: GuildIdSchema,
+    user_id: UserIdSchema,
+    role_id: RoleIdSchema
+}).strict();
+export const CreateRoleSchema = z.object({
+    guild_id: GuildIdSchema,
+    name: z.string()
+        .min(1)
+        .max(100)
+        .describe("Role name"),
+    color: z.number()
+        .int()
+        .min(0)
+        .max(16777215)
+        .optional()
+        .describe("Role color as decimal (e.g., 16711680 for red)"),
+    hoist: z.boolean()
+        .optional()
+        .describe("Whether to display role members separately"),
+    mentionable: z.boolean()
+        .optional()
+        .describe("Whether the role can be mentioned"),
+    permissions: z.array(z.string())
+        .optional()
+        .describe("Array of permission names (e.g., ['SendMessages', 'ManageChannels'])")
+}).strict();
+export const DeleteRoleSchema = z.object({
+    guild_id: GuildIdSchema,
+    role_id: RoleIdSchema
+}).strict();
+export const EditRoleSchema = z.object({
+    guild_id: GuildIdSchema,
+    role_id: RoleIdSchema,
+    name: z.string()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe("New role name"),
+    color: z.number()
+        .int()
+        .min(0)
+        .max(16777215)
+        .optional()
+        .describe("New role color as decimal"),
+    hoist: z.boolean()
+        .optional()
+        .describe("Whether to display role members separately"),
+    mentionable: z.boolean()
+        .optional()
+        .describe("Whether the role can be mentioned"),
+    permissions: z.array(z.string())
+        .optional()
+        .describe("New permission names array")
+}).strict();
+export const SetRolePositionsSchema = z.object({
+    guild_id: GuildIdSchema,
+    positions: z.array(z.object({
+        role_id: RoleIdSchema,
+        position: z.number().int().min(0)
+    })).min(1).describe("Array of role positions to set")
+}).strict();

package/dist/schemas/webhook.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+export declare const ListWebhooksSchema: z.ZodObject<{
+    guild_id: z.ZodOptional<z.ZodString>;
+    channel_id: z.ZodOptional<z.ZodString>;
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: import("../types.js").ResponseFormat;
+    guild_id?: string | undefined;
+    channel_id?: string | undefined;
+}, {
+    response_format?: import("../types.js").ResponseFormat | undefined;
+    guild_id?: string | undefined;
+    channel_id?: string | undefined;
+}>;
+export declare const CreateWebhookSchema: z.ZodObject<{
+    channel_id: z.ZodString;
+    name: z.ZodString;
+    avatar_url: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    channel_id: string;
+    avatar_url?: string | undefined;
+}, {
+    name: string;
+    channel_id: string;
+    avatar_url?: string | undefined;
+}>;
+export declare const EditWebhookSchema: z.ZodObject<{
+    webhook_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    channel_id: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    webhook_id: string;
+    name?: string | undefined;
+    channel_id?: string | undefined;
+}, {
+    webhook_id: string;
+    name?: string | undefined;
+    channel_id?: string | undefined;
+}>;
+export declare const DeleteWebhookSchema: z.ZodObject<{
+    webhook_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    webhook_id: string;
+}, {
+    webhook_id: string;
+}>;
+export type ListWebhooksInput = z.infer<typeof ListWebhooksSchema>;
+export type CreateWebhookInput = z.infer<typeof CreateWebhookSchema>;
+export type EditWebhookInput = z.infer<typeof EditWebhookSchema>;
+export type DeleteWebhookInput = z.infer<typeof DeleteWebhookSchema>;

package/dist/schemas/webhook.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { GuildIdSchema, ChannelIdSchema, WebhookIdSchema, ResponseFormatSchema } from "./common.js";
+export const ListWebhooksSchema = z.object({
+    guild_id: GuildIdSchema.optional()
+        .describe("Guild ID to list all webhooks in the server"),
+    channel_id: ChannelIdSchema.optional()
+        .describe("Channel ID to list webhooks for a specific channel"),
+    response_format: ResponseFormatSchema
+}).strict();
+export const CreateWebhookSchema = z.object({
+    channel_id: ChannelIdSchema,
+    name: z.string()
+        .min(1)
+        .max(80)
+        .describe("Webhook name"),
+    avatar_url: z.string()
+        .url()
+        .optional()
+        .describe("URL of avatar image for the webhook")
+}).strict();
+export const EditWebhookSchema = z.object({
+    webhook_id: WebhookIdSchema,
+    name: z.string()
+        .min(1)
+        .max(80)
+        .optional()
+        .describe("New webhook name"),
+    channel_id: ChannelIdSchema.optional()
+        .describe("Move webhook to a different channel")
+}).strict();
+export const DeleteWebhookSchema = z.object({
+    webhook_id: WebhookIdSchema
+}).strict();

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const server: McpServer;

package/dist/server.js

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+// Initialize MCP Server as a singleton
+export const server = new McpServer({
+    name: "discord-mcp-server",
+    version: "1.0.0",
+});

package/dist/tools/channel.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerChannelTools(server: McpServer): void;