WebDAV MCP Server

Instructions

Implementation Reference

• src/handlers/tool-handlers.ts:127-157 (handler)

  MCP tool handler function that checks if the path exists, deletes the item using WebDAVService, and returns success or error messages.

  async ({ path }) => {
    try {
      // Check if path exists
      const exists = await webdavService.exists(path);
      if (!exists) {
        return {
          content: [{
            type: 'text',
            text: `Error: Path does not exist at ${path}`
          }],
          isError: true
        };
      }
  
      await webdavService.delete(path);
      
      return {
        content: [{
          type: 'text',
          text: `Successfully deleted ${path}`
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: 'text',
          text: `Error deleting: ${(error as Error).message}`
        }],
        isError: true
      };
    }

• src/handlers/tool-handlers.ts:124-126 (schema)

  Zod input schema defining the 'path' parameter for the tool.

  {
    path: z.string().min(1, 'Path must not be empty')
  },

• src/handlers/tool-handlers.ts:122-159 (registration)

  Registration of the 'webdav_delete_remote_item' tool with the MCP server, including name, description, schema, and handler.

    'webdav_delete_remote_item',
    'Delete a file or directory from a remote WebDAV server',
    {
      path: z.string().min(1, 'Path must not be empty')
    },
    async ({ path }) => {
      try {
        // Check if path exists
        const exists = await webdavService.exists(path);
        if (!exists) {
          return {
            content: [{
              type: 'text',
              text: `Error: Path does not exist at ${path}`
            }],
            isError: true
          };
        }
  
        await webdavService.delete(path);
        
        return {
          content: [{
            type: 'text',
            text: `Successfully deleted ${path}`
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: 'text',
            text: `Error deleting: ${(error as Error).message}`
          }],
          isError: true
        };
      }
    }
  );

• src/services/webdav-service.ts:201-227 (helper)

  Supporting WebDAVService.delete method called by the tool handler to perform the actual deletion via WebDAV client.

  async delete(path: string): Promise<void> {
    const fullPath = this.getFullPath(path);
    logger.debug(`Deleting: ${fullPath}`);
    
    try {
      // Get type before deleting for better logging
      const stat = await this.stat(fullPath).catch(() => null);
      const itemType = stat?.type || 'item';
      
      // deleteFile in v5.x returns a boolean indicating success
      const result = await this.client.deleteFile(fullPath);
      
      // Check result based on type
      if (typeof result === 'boolean' && !result) {
        throw new Error("Failed to delete: server returned failure status");
      } else if (this.isResponseData(result) && 
                 result.status !== undefined && 
                 result.status !== 204) {
        throw new Error(`Failed to delete: server returned status ${result.status}`);
      }
      
      logger.debug(`Successfully deleted ${itemType}: ${fullPath}`);
    } catch (error) {
      logger.error(`Error deleting ${fullPath}:`, error);
      throw new Error(`Failed to delete: ${(error as Error).message}`);
    }
  }

• src/handlers/prompt-handlers.ts:78-105 (registration)

  Registration of prompt handler for 'webdav_delete_remote_item' with MCP server.

      'webdav_delete_remote_item',
      // The issue is with boolean not being compatible with the prompt schema
      // Using string as a workaround
      {
        path: z.string().min(1, 'Path must not be empty'),
        confirm: z.string().optional()
      },
      (args) => {
        const confirmationEnabled = args.confirm !== 'false';
        const pathValue = args.path;
        const isDirectory = pathValue.endsWith('/');
        
        return {
          messages: [
            {
              role: 'user',
              content: {
                type: 'text',
                text: `Delete the ${isDirectory ? 'directory' : 'file'} at "${pathValue}" from the remote WebDAV server.
  ${confirmationEnabled ? 'Please confirm this action to proceed with deletion.' : 'Execute this remote deletion operation.'}
  
  Please confirm when the remote WebDAV deletion is complete.`
              }
            }
          ]
        };
      }
    );