Merge pull request #25 from btallman/feat/roles-and-permissions

feat: add role management, member tools, voice channels, and channel permissions

Author: barryyip0625

src/index.ts

@@ -59,7 +59,8 @@ const client = new Client({
     intents: [
         GatewayIntentBits.Guilds,
         GatewayIntentBits.GuildMessages,
-        GatewayIntentBits.MessageContent
+        GatewayIntentBits.MessageContent,
+        GatewayIntentBits.GuildMembers
     ]
 });
 

src/schemas.ts

@@ -49,12 +49,11 @@ export const ReplyToForumSchema = z.object({
 });
 
 export const CreateTextChannelSchema = z.object({
-    guildId: z.string({ description: "The ID of the server (guild) where the text channel will be created." }),
-    channelName: z.string({ description: "The name for the new text channel." }),
-    topic: z.string({ description: "The (optional) topic/description for the channel." }).optional(),
-    reason: z.string({ description: "Optional reason for audit logs when creating the channel." }).optional()
-}, {
-    description: "Create a new text channel in a specified server (guild)."
+    guildId: z.string(),
+    channelName: z.string(),
+    topic: z.string().optional(),
+    categoryId: z.string().optional(),
+    reason: z.string().optional()
 });
 
 // Category schemas
@@ -204,6 +203,88 @@ export const ListServersSchema = z.object({}, {
     description: "List all servers (guilds) the bot is a member of."
 });
 
+// Role schemas
+export const ListRolesSchema = z.object({
+    guildId: z.string()
+});
+
+export const CreateRoleSchema = z.object({
+    guildId: z.string(),
+    name: z.string(),
+    color: z.string().optional(),
+    hoist: z.boolean().optional(),
+    mentionable: z.boolean().optional(),
+    permissions: z.array(z.string()).optional(),
+    reason: z.string().optional()
+});
+
+export const EditRoleSchema = z.object({
+    guildId: z.string(),
+    roleId: z.string(),
+    name: z.string().optional(),
+    color: z.string().optional(),
+    hoist: z.boolean().optional(),
+    mentionable: z.boolean().optional(),
+    permissions: z.array(z.string()).optional(),
+    position: z.number().optional(),
+    reason: z.string().optional()
+});
+
+export const DeleteRoleSchema = z.object({
+    guildId: z.string(),
+    roleId: z.string(),
+    reason: z.string().optional()
+});
+
+export const AssignRoleSchema = z.object({
+    guildId: z.string(),
+    userId: z.string(),
+    roleId: z.string(),
+    reason: z.string().optional()
+});
+
+export const RemoveRoleSchema = z.object({
+    guildId: z.string(),
+    userId: z.string(),
+    roleId: z.string(),
+    reason: z.string().optional()
+});
+
+export const ListMembersSchema = z.object({
+    guildId: z.string(),
+    limit: z.number().min(1).max(1000).optional().default(100),
+    after: z.string().optional()
+});
+
+export const GetMemberSchema = z.object({
+    guildId: z.string(),
+    userId: z.string()
+});
+
+// Channel permission schemas
+export const SetChannelPermissionsSchema = z.object({
+    channelId: z.string(),
+    roleId: z.string(),
+    allow: z.array(z.string()).optional(),
+    deny: z.array(z.string()).optional(),
+    reason: z.string().optional()
+});
+
+export const RemoveChannelPermissionsSchema = z.object({
+    channelId: z.string(),
+    roleId: z.string(),
+    reason: z.string().optional()
+});
+
+// Voice channel schema
+export const CreateVoiceChannelSchema = z.object({
+    guildId: z.string(),
+    channelName: z.string(),
+    categoryId: z.string().optional(),
+    userLimit: z.number().min(0).max(99).optional(),
+    reason: z.string().optional()
+});
+
 export const SearchMessagesSchema = z.object({
     guildId: z.string({ description: "The ID of the server (guild) to search in." }).min(1, "guildId is required"),
     // Optional filters

src/server.ts

@@ -34,6 +34,17 @@ import {
   createCategoryHandler,
   editCategoryHandler,
   deleteCategoryHandler,
+  createVoiceChannelHandler,
+  setChannelPermissionsHandler,
+  removeChannelPermissionsHandler,
+  listRolesHandler,
+  createRoleHandler,
+  editRoleHandler,
+  deleteRoleHandler,
+  assignRoleHandler,
+  removeRoleHandler,
+  listMembersHandler,
+  getMemberHandler,
   listServersHandler,
   searchMessagesHandler
 } from './tools/tools.js';
@@ -214,6 +225,50 @@ export class DiscordMCPServer {
             toolResponse = await searchMessagesHandler(args, this.toolContext);
             return toolResponse;
 
+          case "discord_list_roles":
+            toolResponse = await listRolesHandler(args, this.toolContext);
+            return toolResponse;
+
+          case "discord_create_role":
+            toolResponse = await createRoleHandler(args, this.toolContext);
+            return toolResponse;
+
+          case "discord_edit_role":
+            toolResponse = await editRoleHandler(args, this.toolContext);
+            return toolResponse;
+
+          case "discord_delete_role":
+            toolResponse = await deleteRoleHandler(args, this.toolContext);
+            return toolResponse;
+
+          case "discord_assign_role":
+            toolResponse = await assignRoleHandler(args, this.toolContext);
+            return toolResponse;
+
+          case "discord_remove_role":
+            toolResponse = await removeRoleHandler(args, this.toolContext);
+            return toolResponse;
+
+          case "discord_list_members":
+            toolResponse = await listMembersHandler(args, this.toolContext);
+            return toolResponse;
+
+          case "discord_get_member":
+            toolResponse = await getMemberHandler(args, this.toolContext);
+            return toolResponse;
+
+          case "discord_create_voice_channel":
+            toolResponse = await createVoiceChannelHandler(args, this.toolContext);
+            return toolResponse;
+
+          case "discord_set_channel_permissions":
+            toolResponse = await setChannelPermissionsHandler(args, this.toolContext);
+            return toolResponse;
+
+          case "discord_remove_channel_permissions":
+            toolResponse = await removeChannelPermissionsHandler(args, this.toolContext);
+            return toolResponse;
+
           default:
             throw new Error(`Unknown tool: ${name}`);
         }

src/toolList.ts

@@ -129,13 +129,14 @@ export const toolList = [
   },
   {
     name: "discord_create_text_channel",
-    description: "Creates a new text channel in a Discord server with an optional topic",
+    description: "Creates a new text channel in a Discord server with an optional topic and parent category",
     inputSchema: {
       type: "object",
       properties: {
         guildId: { type: "string" },
         channelName: { type: "string" },
-        topic: { type: "string" }
+        topic: { type: "string" },
+        categoryId: { type: "string", description: "Parent category ID to place the channel under" }
       },
       required: ["guildId", "channelName"]
     }
@@ -378,5 +379,161 @@ export const toolList = [
       },
       required: ["guildId"]
     }
+  },
+  {
+    name: "discord_list_roles",
+    description: "Lists all roles in a Discord server with their properties",
+    inputSchema: {
+      type: "object",
+      properties: {
+        guildId: { type: "string" }
+      },
+      required: ["guildId"]
+    }
+  },
+  {
+    name: "discord_create_role",
+    description: "Creates a new role in a Discord server",
+    inputSchema: {
+      type: "object",
+      properties: {
+        guildId: { type: "string" },
+        name: { type: "string" },
+        color: { type: "string", description: "Hex color string (e.g. '#FF0000') or color name" },
+        hoist: { type: "boolean", description: "Whether the role should be displayed separately in the sidebar" },
+        mentionable: { type: "boolean", description: "Whether the role can be mentioned by anyone" },
+        permissions: { type: "array", items: { type: "string" }, description: "Array of permission flag names (e.g. ['SendMessages', 'ViewChannel'])" },
+        reason: { type: "string" }
+      },
+      required: ["guildId", "name"]
+    }
+  },
+  {
+    name: "discord_edit_role",
+    description: "Edits an existing role in a Discord server",
+    inputSchema: {
+      type: "object",
+      properties: {
+        guildId: { type: "string" },
+        roleId: { type: "string" },
+        name: { type: "string" },
+        color: { type: "string", description: "Hex color string (e.g. '#FF0000') or color name" },
+        hoist: { type: "boolean" },
+        mentionable: { type: "boolean" },
+        permissions: { type: "array", items: { type: "string" }, description: "Array of permission flag names" },
+        position: { type: "number", description: "New position in the role hierarchy" },
+        reason: { type: "string" }
+      },
+      required: ["guildId", "roleId"]
+    }
+  },
+  {
+    name: "discord_delete_role",
+    description: "Deletes a role from a Discord server",
+    inputSchema: {
+      type: "object",
+      properties: {
+        guildId: { type: "string" },
+        roleId: { type: "string" },
+        reason: { type: "string" }
+      },
+      required: ["guildId", "roleId"]
+    }
+  },
+  {
+    name: "discord_assign_role",
+    description: "Assigns a role to a member in a Discord server",
+    inputSchema: {
+      type: "object",
+      properties: {
+        guildId: { type: "string" },
+        userId: { type: "string" },
+        roleId: { type: "string" },
+        reason: { type: "string" }
+      },
+      required: ["guildId", "userId", "roleId"]
+    }
+  },
+  {
+    name: "discord_remove_role",
+    description: "Removes a role from a member in a Discord server",
+    inputSchema: {
+      type: "object",
+      properties: {
+        guildId: { type: "string" },
+        userId: { type: "string" },
+        roleId: { type: "string" },
+        reason: { type: "string" }
+      },
+      required: ["guildId", "userId", "roleId"]
+    }
+  },
+  {
+    name: "discord_list_members",
+    description: "Lists members in a Discord server with their roles",
+    inputSchema: {
+      type: "object",
+      properties: {
+        guildId: { type: "string" },
+        limit: { type: "number", description: "Maximum number of members to return (default 100, max 1000)", minimum: 1, maximum: 1000, default: 100 },
+        after: { type: "string", description: "User ID to paginate after" }
+      },
+      required: ["guildId"]
+    }
+  },
+  {
+    name: "discord_get_member",
+    description: "Gets detailed information about a specific member in a Discord server",
+    inputSchema: {
+      type: "object",
+      properties: {
+        guildId: { type: "string" },
+        userId: { type: "string" }
+      },
+      required: ["guildId", "userId"]
+    }
+  },
+  {
+    name: "discord_create_voice_channel",
+    description: "Creates a new voice channel in a Discord server with an optional parent category",
+    inputSchema: {
+      type: "object",
+      properties: {
+        guildId: { type: "string" },
+        channelName: { type: "string" },
+        categoryId: { type: "string", description: "Parent category ID to place the channel under" },
+        userLimit: { type: "number", description: "Maximum number of users allowed (0 for unlimited)", minimum: 0, maximum: 99 },
+        reason: { type: "string" }
+      },
+      required: ["guildId", "channelName"]
+    }
+  },
+  {
+    name: "discord_set_channel_permissions",
+    description: "Sets permission overrides for a role or user on a channel or category",
+    inputSchema: {
+      type: "object",
+      properties: {
+        channelId: { type: "string", description: "Channel or category ID" },
+        roleId: { type: "string", description: "Role or user ID to set permissions for" },
+        allow: { type: "array", items: { type: "string" }, description: "Permission flags to allow (e.g. ['ViewChannel', 'SendMessages'])" },
+        deny: { type: "array", items: { type: "string" }, description: "Permission flags to deny (e.g. ['ViewChannel', 'SendMessages'])" },
+        reason: { type: "string" }
+      },
+      required: ["channelId", "roleId"]
+    }
+  },
+  {
+    name: "discord_remove_channel_permissions",
+    description: "Removes all permission overrides for a role or user on a channel or category",
+    inputSchema: {
+      type: "object",
+      properties: {
+        channelId: { type: "string", description: "Channel or category ID" },
+        roleId: { type: "string", description: "Role or user ID to remove overrides for" },
+        reason: { type: "string" }
+      },
+      required: ["channelId", "roleId"]
+    }
   }
 ];