deep-directory-tree

Deep Directory Tree MCP visualizes and analyzes your project directory structure so AI assistants can understand and navigate it more effectively. It supports configurable depth-based tree generation, exclusion patterns for files and folders, and a clean, readable tree output that can be fed into conversations with Claude or other MCP-enabled tools. Use the MCP to request directory structures, visualize project layouts, or perform targeted analyses (e.g., excluding test folders or focusing on a specific subtree). The server is designed to work with common MCP tools like Cursor and Claude Desktop, enabling real-time or on-demand structure insights during your workflows.

Prerequisites:

• Node.js v18 or higher
• npm or npx available in your environment

Installation (Smithery):

npx -y @smithery/cli install @andredezzy/deep-directory-tree-mcp --client cursor

Manual installation (Node.js runtime):

# Install the MCP server as a local dependency (example usage with npx)
npx -y @andredezzy/deep-directory-tree-mcp

If you prefer to run directly from your project, you can install the package locally and run the server script as documented by the package:

npm install --save-dev @andredezzy/deep-directory-tree-mcp
# Then run the MCP server according to the package's bin/script entry point

Configuration for MCP clients (examples):

{
  "mcpServers": {
    "deep-directory-tree": {
      "command": "npx",
      "args": ["-y", "@andredezzy/deep-directory-tree-mcp"]
    }
  }
}

Tips:

• If you customize theCLI or package path, ensure ABSOLUTE_PATH_TO_MCP_SERVER/bin/deep-directory-tree.js usage is aligned with your environment as shown in advanced Cursor/Claude setups.
• For performance, configure a reasonable depth and exclusion patterns to keep the tree output readable and fast.
• Check the repository wiki or issues for any environment-specific notes or recent changes to the MCP integration.
• If using Bun for development, you can follow the project-specific Bun setup steps; otherwise Node.js is sufficient for runtime MCP usage.