deep-directory-tree-mcp

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:

Cursor + Deep Directory Tree MCP Demo

Quick Start

Prerequisites

Node.js (v18 or higher)

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

Open Cursor Settings → MCP → Add new MCP server
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

Bun Runtime (required)

# 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

Open Cursor Settings → MCP → Add new MCP server
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

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

Support

Need help? Try these resources:

License

MIT License - see LICENSE file for details.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

get_deep_directory_tree

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-neurolora
aindreyway
A
security
A
license
A
quality
Provides tools for collecting and documenting code from directories.
Last updated 7 months ago
4
565
14
TypeScript
MIT License
SourceSage MCP
Sunwood-ai-labs
A
security
F
license
A
quality
A TypeScript-based server that visualizes project directory structures in Markdown format, automatically documenting file contents with syntax highlighting and supporting customizable exclusion patterns.
Last updated 7 months ago
1
248
2
TypeScript
deep-filesystem-tree
andredezzy
A
security
A
license
A
quality
A Model Context Protocol (MCP) implementation that provides deep filesystem tree visualization and manipulation capabilities. This tool enables efficient navigation and management of complex directory structures, enhancing development workflows with AI-powered file system operations. Compatible with
Last updated 4 months ago
1
22
6
TypeScript
MIT License
Code Context Provider MCP
AB498
A
security
A
license
A
quality
Provides code context and analysis for AI assistants by extracting directory structures and code symbols using WebAssembly Tree-sitter parsers with zero native dependencies.
Last updated 2 months ago
1
265
6
JavaScript
MIT License

View all related MCP servers

deep-directory-tree-mcp