pyodide_list-mounted-directory
List files and directories in a mounted Pyodide filesystem to inspect accessible Python execution environments for LLMs.
Instructions
List contents of a mounted directory
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mountName | Yes | Name of the mount point |
Implementation Reference
- Core implementation of the tool: lists directory contents using Pyodide Python os.listdir on the mounted filesystem, categorizing files and directories.
async listMountedDirectory(mountName: string) { if (!this.pyodide) { return formatCallToolError("Pyodide not initialized"); } const mountConfig = this.mountPoints.get(mountName); if (!mountConfig) { return formatCallToolError(`Mount point not found: ${mountName}`); } try { // Use Python code to get directory contents const pythonCode = ` import os def list_directory(path): contents = [] try: for item in os.listdir(path): full_path = os.path.join(path, item) if os.path.isfile(full_path): contents.append(f"FILE: {item}") elif os.path.isdir(full_path): contents.append(f"DIR: {item}") except Exception as e: print(f"Error listing directory: {e}") return [] return contents list_directory("${mountConfig.mountPoint}") `; return await this.executePython(pythonCode, 5000); } catch (error) { return formatCallToolError(error); } } - src/tools/index.ts:49-62 (schema)Tool schema definition including name, description, and input schema requiring 'mountName'.
export const LIST_MOUNTED_DIRECTORY_TOOL: Tool = { name: "pyodide_list-mounted-directory", description: "List contents of a mounted directory", inputSchema: { type: "object", properties: { mountName: { type: "string", description: "Name of the mount point", }, }, required: ["mountName"], }, }; - src/handlers/index.ts:109-117 (handler)Handler dispatch case: validates input using arktype and calls PyodideManager.listMountedDirectory.
case "pyodide_list-mounted-directory": { const listMountedDirectoryArgs = isListMountedDirectoryArgs(args); if (listMountedDirectoryArgs instanceof type.errors) { throw listMountedDirectoryArgs; } const { mountName } = listMountedDirectoryArgs; const results = await pyodideManager.listMountedDirectory(mountName); return results; } - src/handlers/index.ts:32-38 (registration)Registers the tool by including it in the TOOLS array returned by ListToolsRequest handler.
const TOOLS: Tool[] = [ tools.EXECUTE_PYTHON_TOOL, tools.INSTALL_PYTHON_PACKAGES_TOOL, tools.GET_MOUNT_POINTS_TOOL, tools.LIST_MOUNTED_DIRECTORY_TOOL, tools.READ_IMAGE_TOOL, ];