A favicon of Deep Directory Tree

Deep Directory Tree

Powerful Model Context Protocol (MCP) implementation for visualizing directory structures with real-time updates, configurable depth, and smart exclusions for efficient project navigation

Installation

Installing for Claude Desktop

Option 1: One-Command Installation

npx mcpbar install andredezzy/deep-directory-tree-mcp -c claude

This command will automatically install and configure the Deep Directory Tree MCP server for your selected client.

Option 2: Manual Configuration

View JSON configuration
{
  "mcpServers": {
    "Deep Directory Tree": {
      "command": "npx",
      "args": [
        "-y",
        "@andredezzy/deep-directory-tree-mcp"
      ]
    }
  }
}

Copy and paste this configuration into your MCP client's configuration file to manually set up this server.

Common MCP clients
  • claude - Claude Desktop
  • cursor - Cursor Code Editor
  • cline - Cline (VS Code)
  • windsurf - Windsurf Editor
  • witsy - Witsy AI Assistant

Deep Directory Tree MCP 🌳

Smithery Tool Calls NPM Version NPM Downloads

A powerful Model Context Protocol (MCP) implementation for visualizing and analyzing directory structures. Why? Now you can let AI assistants understand and navigate your project structure efficiently, enabling smarter code navigation and project organization insights.

Built with:

Features

  • Deep directory tree visualization
  • Configurable depth-based tree generation
  • Smart pattern-based file/directory exclusion
  • Clean and readable tree output format
  • Real-time directory structure updates
  • Targeted directory analysis

DEMO:

Cursor + Deep Directory Tree MCP Demo

Quick Start

Prerequisites

Smithery Installation

The easiest way to get started is using Smithery:

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

Manual Installation

Cursor IDE Setup

  1. Open Cursor Settings → MCP → Add new MCP server

  2. Configure with these settings:

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

Claude Desktop Setup

Add the following to your MCP configuration:

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

Usage

Common commands for AI assistants:

  • "Show me the directory structure"
  • "Visualize project tree up to depth 4"
  • "Show files excluding test directories"

Development

Prerequisites

# Clone the repository
git clone https://github.com/andredezzy/deep-directory-tree-mcp.git
cd deep-directory-tree-mcp

# Install dependencies
bun install

# Build the project
bun run build

Development Manual Installation

Cursor IDE Setup

  1. Open Cursor Settings → MCP → Add new MCP server

  2. Configure with these settings:

    {
      "deep-directory-tree": {
        "command": "node",
        "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/bin/deep-directory-tree.js"]
      }
    }
    

Claude Desktop Setup

Add the following to your MCP configuration:

{
  "mcpServers": {
    "deep-directory-tree": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/bin/deep-directory-tree.js"]
    }
  }
}

Contributing

  1. Fork the repository
  2. Create feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Support

Need help? Try these resources:

License

MIT License - see LICENSE file for details.

Share:
Details:
  • Stars


    6
  • Forks


    0
  • Last commit


    26 days ago
  • Repository age


    27 days
  • License


    MIT
View Repository

Auto-fetched from GitHub .

MCP servers similar to Deep Directory Tree:

 

 
 
  • Stars


  • Forks


  • Last commit


 

 
 
  • Stars


  • Forks


  • Last commit


 

 
 
  • Stars


  • Forks


  • Last commit


Deep Directory Tree: MCP Server – MCP.Bar