-
securityA
license-
qualityA Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.
Last updated -
5
MIT License
Supports analysis of GitHub repositories through directory structure visualization, helping AI assistants provide better project organization insights and code navigation guidance.
Enables directory tree visualization and analysis for Node.js projects, with support for configurable depth, pattern-based exclusions, and targeted directory analysis.
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.
local-only server
The server can only run on the client's local machine because it depends on local resources.
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
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables enhanced file system operations including reading, writing, copying, moving files with streaming capabilities, directory management, file watching, and change tracking.Last updated -17MIT License
- -securityAlicense-qualityA Model Context Protocol (MCP) server that allows AI models to safely access and interact with local file systems, enabling reading file contents, listing directories, and retrieving file metadata.Last updated -610MIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides secure and intelligent interaction with files and filesystems, offering smart context management and token-efficient operations for working with large files and complex directory structures.Last updated -2148MIT License