WebDAV MCP Server

Instructions

Implementation Reference

• src/handlers/tool-handlers.ts:301-336 (handler)

  MCP tool handler implementation for 'webdav_list_remote_directory'. Registers the tool with Zod input schema (path optional, defaults to '/'), executes webdavService.list(path), formats results as JSON, and returns as text content or error.
  server.tool( 'webdav_list_remote_directory', 'List files and directories at the specified path on a remote WebDAV server', { path: z.string().optional().default('/') }, async ({ path }) => { try { const files = await webdavService.list(path); // Format response const formattedFiles = files.map(file => ({ name: file.basename, path: file.filename, type: file.type, size: file.size, lastModified: file.lastmod })); return { content: [{ type: 'text', text: JSON.stringify(formattedFiles, null, 2) }] }; } catch (error) { return { content: [{ type: 'text', text: `Error listing directory: ${(error as Error).message}` }], isError: true }; } } );
• src/services/webdav-service.ts:65-86 (helper)

  Core helper method implementing directory listing using WebDAVClient.getDirectoryContents, handling response formats, converting to FileStat[], with full path resolution and logging.
  async list(path: string = '/'): Promise<FileStat[]> { const fullPath = this.getFullPath(path); logger.debug(`Listing directory: ${fullPath}`); try { // In v5.x we need to handle the response differently const result = await this.client.getDirectoryContents(fullPath); // Convert the result to our FileStat interface const fileStats = Array.isArray(result) ? result.map(item => this.convertToFileStat(item)) : this.isResponseData(result) && Array.isArray(result.data) ? result.data.map(item => this.convertToFileStat(item)) : []; logger.debug(`Listed ${fileStats.length} items in directory: ${fullPath}`); return fileStats; } catch (error) { logger.error(`Error listing directory ${fullPath}:`, error); throw new Error(`Failed to list directory: ${(error as Error).message}`); } }
• src/lib.ts:77-79 (registration)

  Top-level server initialization calls setupToolHandlers(server, webdavService), which registers the 'webdav_list_remote_directory' tool among others.
  setupResourceHandlers(server, webdavService); setupToolHandlers(server, webdavService); setupPromptHandlers(server);
• src/handlers/tool-handlers.ts:304-306 (schema)

  Zod input schema for the tool: path as optional string defaulting to '/'.
  { path: z.string().optional().default('/') },
• src/services/webdav-service.ts:380-380 (helper)

  Supporting utility for basename extraction used in FileStat conversion.
  private getBasenameFromPath(path: string): string {