Deep Directory Tree MCP

🚀 Deep Directory Tree MCP 🌳

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

Built with the following technologies:

• Anthropic MCP
• Cursor

✨ Features

• Deep directory tree visualization
• Tree generation with configurable depth
• Intelligent mode based on file/directory exclusion
• Clean and readable tree output format
• Real-time directory structure updates
• Intelligent analysis for directories

DEMO:

🚀 Quick Start

Prerequisites

• Node.js (v18 or higher)

Smithery Installation

The easiest way is to use Smithery:

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

Manual Installation

Cursor IDE Setup

1. Open Cursor settings → MCP → Add a new MCP server.
2. Use the following configuration 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 Examples

Common commands for AI assistants:

• "Show the directory structure"
• "Visualize the project tree up to depth 4"
• "Exclude files in the test directory"

🔧 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

Manual Installation for Development

Cursor IDE Setup

1. Open Cursor settings → MCP → Add a new MCP server.
2. Use the following configuration 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"]
    }
  }
}

🤝 Contribution Guidelines

Submit Issues and Feedback

• If you encounter any issues, please submit them in Issues.
• If you have any suggestions or feature requests, feel free to share them.

Create a Branch

• After cloning the repository, create a new feature branch:

git checkout -b feature/new-feature

• Commit your changes and push them to the branch.
• Create a pull request to the main branch.

🤗 Support

If you find this project helpful, please consider supporting it. You can support it in the following ways:

• Star the repository: Show your recognition of the project.
• Provide feedback: Help improve the project.
• Contribute code: Participate in project development.

Thank you for your support!