deep-directory-tree-mcp

by andredezzy
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Required runtime for development of the MCP server

  • Required runtime environment for the MCP server, used to analyze and visualize directory structures

Deep Directory Tree MCP 🌳

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:

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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Deep directory tree visualization tool enabling efficient visualization of complex directory structures with AI-powered analysis capabilities.

  1. Features
    1. Quick Start
      1. Prerequisites
      2. Smithery Installation
      3. Manual Installation
    2. Usage
      1. Development
        1. Prerequisites
        2. Development Manual Installation
      2. Contributing
        1. Support
          1. License
            ID: zbfxs2f02m