directory_tree

Generate and visualize a recursive directory structure with customizable depth, file inclusion, and pattern filtering. Supports text or JSON output for clear file hierarchy representation.

Instructions

Get a recursive tree view of files and directories.

Args:
    path: Root directory
    max_depth: Maximum recursion depth
    include_files: Whether to include files (not just directories)
    pattern: Optional glob pattern to filter entries
    exclude_patterns: Optional patterns to exclude
    format: Output format ('text' or 'json')
    ctx: MCP context

Returns:
    Formatted directory tree

Input Schema

Name	Required	Default
`exclude_patterns`	No
`format`	No	text
`include_files`	No
`max_depth`	No
`path`	Yes
`pattern`	No

Input Schema (JSON Schema)

{
  "properties": {
    "exclude_patterns": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Exclude Patterns"
    },
    "format": {
      "default": "text",
      "title": "Format",
      "type": "string"
    },
    "include_files": {
      "default": true,
      "title": "Include Files",
      "type": "boolean"
    },
    "max_depth": {
      "default": 3,
      "title": "Max Depth",
      "type": "integer"
    },
    "path": {
      "title": "Path",
      "type": "string"
    },
    "pattern": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Pattern"
    }
  },
  "required": [
    "path"
  ],
  "title": "directory_treeArguments",
  "type": "object"
}

MCP Filesystem Server

directory_tree

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from MCP Filesystem Server

Related Tools

MCP directory API