Deep Directory Tree MCP
Visualize directory structures with real-time updates, configurable depth, and smart exclusions for efficient project navigation.
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
- 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.
Related Servers
JSON MCP Server
A high-performance MCP server for comprehensive JSON file operations, including reading, writing, and advanced querying, optimized for LLM interactions.
Excel MCP Server
An MCP server for manipulating and managing Excel files.
Filesystem MCP Server
A secure server for filesystem operations with controlled access to specified directories.
Music Collection MCP Server
An MCP server for intelligent access to your local music collection, featuring metadata management, band discovery, and advanced querying.
PDF MCP Server
Extract text and data from PDF files using pdfplumber by providing local file paths.
KnowledgeBaseMCP
Extract text content from local PDF, DOCX, and PPTX files to build a knowledge base.
Claude Text Editor
An MCP server for viewing, editing, and creating text files, based on the Claude built-in text editor tool.
CData FTP Server
A read-only MCP server for querying live FTP data using the CData JDBC Driver.
File System MCP Server
A server for comprehensive file and directory management on the local file system.
AI FileSystem MCP
An AI-powered MCP server for advanced file system operations, including search, comparison, and security analysis.