Unrestricted Development MCP Server

Instructions

Implementation Reference

• src/tools/filesystem.ts:309-343 (handler)

  The core handler function that implements the fs_delete_directory tool logic. It deletes the specified directory using Node.js fs.promises.rm (recursive with force if specified) or fs.rmdir (non-recursive), and returns a standardized ToolResponse.

  export async function deleteDirectory(args: z.infer<typeof deleteDirectorySchema>): Promise<ToolResponse> {
    try {
      if (args.recursive) {
        await fs.rm(args.path, { recursive: true, force: true });
      } else {
        await fs.rmdir(args.path);
      }
  
      return {
        content: [
          {
            type: "text" as const,
            text: JSON.stringify({
              success: true,
              path: args.path,
              message: 'Directory deleted successfully'
            }, null, 2)
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text" as const,
            text: JSON.stringify({
              success: false,
              error: error instanceof Error ? error.message : String(error)
            }, null, 2)
          }
        ],
        isError: true
      };
    }
  }

• src/tools/filesystem.ts:46-49 (schema)

  Zod schema used for input validation in the deleteDirectory handler and dispatch.

  export const deleteDirectorySchema = z.object({
    path: z.string().describe('Absolute or relative path to the directory to delete'),
    recursive: z.boolean().default(false).describe('Delete directory and all contents recursively')
  });

• src/tools/filesystem.ts:585-603 (schema)

  JSON schema definition for the fs_delete_directory tool, part of the exported filesystemTools array used for MCP tool registration.

  {
    name: 'fs_delete_directory',
    description: 'Delete a directory. Can recursively delete all contents. WARNING: Use with caution as this is irreversible.',
    inputSchema: {
      type: 'object',
      properties: {
        path: {
          type: 'string',
          description: 'Absolute or relative path to the directory to delete'
        },
        recursive: {
          type: 'boolean',
          default: false,
          description: 'Delete directory and all contents recursively'
        }
      },
      required: ['path']
    }
  },

• src/index.ts:329-332 (registration)

  Dispatch/registration logic in the main server handler that matches tool name 'fs_delete_directory', validates input with deleteDirectorySchema, and invokes the deleteDirectory handler.

  if (name === 'fs_delete_directory') {
    const validated = deleteDirectorySchema.parse(args);
    return await deleteDirectory(validated);
  }