Tree Explorer

🚀 MCP Tree Explorer

A lightweight MCP tool for visualizing directory trees in Cursor.

🚀 Quick Start

The MCP Tree Explorer is a handy tool that allows you to visualize directory trees in Cursor. It simplifies the process of exploring project directories, especially in large projects.

✨ Features

• Visualize the directory structure using the tree command.
• Intelligently filter common large folders (e.g., node_modules, .git, etc.).
• Customize ignore and keep patterns.
• Automatically install the tree command if it's not installed.
• Support Windows, macOS, and Linux systems.

📦 Installation

# Install using pip
pip install mcp-tree-explorer

# Install using uv
uv pip install mcp-tree-explorer

💻 Usage Examples

Basic Usage

Add the tool to the Cursor configuration by editing the Cursor configuration file:

{
  "tools": {
    "mcp-tree-explorer": {
      "command": "mcp-tree-explorer"
    }
  }
}

Advanced Usage

The project_tree tool supports the following parameters:

• directory: The directory to check (default: current directory).
• depth: The maximum depth of the tree (optional, no limit if not specified).
• ignore: Additional ignore patterns, comma-separated (optional).
• keep: Patterns to keep even if they match the auto-ignore patterns, comma-separated (optional).

Example usages:

• “Show the directory structure of this project.”
• “Run the tree command in the src directory but include node_modules.”
• “Show the project tree, ignoring test files but keeping the dist folder.”

📚 Documentation

Development

# Clone the repository
git clone https://github.com/yourusername/mcp-tree-explorer.git
cd mcp-tree-explorer

# Install in development mode
uv pip install -e .

📄 License

MIT