list_directory
Generate a detailed file and directory listing for a specified path within allowed directories. Results include [FILE] and [DIR] prefixes for clear distinction.
Instructions
Get a detailed listing of all files and directories in a specified path. Results distinguish between files and directories with [FILE] and [DIR] prefixes. Only works within allowed directories.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes |
Implementation Reference
- src/tools/filesystem.ts:95-99 (handler)Core handler function implementing the list_directory tool logic: validates path, reads directory entries, formats with [DIR]/[FILE] prefixes, returns list of strings.export async function listDirectory(dirPath: string): Promise<string[]> { const validPath = await validatePath(dirPath); const entries = await fs.readdir(validPath, { withFileTypes: true }); return entries.map((entry) => `${entry.isDirectory() ? "[DIR]" : "[FILE]"} ${entry.name}`); }
- src/tools/schemas.ts:49-51 (schema)Zod schema defining input for list_directory tool: requires a 'path' string.export const ListDirectoryArgsSchema = z.object({ path: z.string(), });
- src/server.ts:157-162 (registration)Tool registration in MCP server: defines name, description, and converts Zod schema to JSON schema for input validation.name: "list_directory", description: "Get a detailed listing of all files and directories in a specified path. " + "Results distinguish between files and directories with [FILE] and [DIR] prefixes. " + "Only works within allowed directories.", inputSchema: zodToJsonSchema(ListDirectoryArgsSchema),
- src/server.ts:294-299 (handler)MCP request handler dispatch for list_directory: parses args, calls listDirectory, formats response as MCP content.case "list_directory": { const parsed = ListDirectoryArgsSchema.parse(args); const entries = await listDirectory(parsed.path); return { content: [{ type: "text", text: entries.join('\n') }], };