Tree Explorer

🚀 MCPツリーエクスプローラ

軽量なMCPツールで、Cursor内でディレクトリツリーを可視化します。

🚀 クイックスタート

MCPツリーエクスプローラは、Cursor内でディレクトリ構造を可視化するための便利なツールです。以下の手順で簡単に導入して利用できます。

✨ 主な機能

• treeコマンドを使用してディレクトリ構造を可視化します。
• node_modulesや.gitなどの一般的な大きなフォルダを自動的にフィルタリングします。
• 無視するパターンと保持するパターンをカスタマイズできます。
• treeコマンドがインストールされていない場合は自動でインストールします。
• Windows、macOS、Linuxの各OSに対応しています。

📦 インストール

# pipを使用してインストール
pip install mcp-tree-explorer

# uvを使用してインストール
uv pip install mcp-tree-explorer

💻 使用例

基本的な使用法

Cursorの設定ファイルを編集して、このツールを設定に追加します。

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

高度な使用法

project_treeツールは以下のパラメータをサポートしています。

• directory: チェックするディレクトリ（デフォルト: カレントディレクトリ）
• depth: ツリーの最大深度（オプション、指定しない場合は深度制限なし）
• ignore: 追加で無視するパターン（カンマ区切り、オプション）
• keep: 自動無視パターンにマッチしても保持するパターン（カンマ区切り、オプション）

例えば以下のような使い方ができます。

• “このプロジェクトのディレクトリ構造を表示”
• “srcディレクトリでtreeコマンドを実行し、node_modulesを含める”
• “プロジェクトツリーを表示し、テストファイルを無視してdistフォルダを保持”

🔧 技術詳細

開発手順

# リポジトリをクローン
git clone https://github.com/yourusername/mcp-tree-explorer.git
cd mcp-tree-explorer

# 開発モードでインストール
uv pip install -e .

📄 ライセンス

このプロジェクトはMITライセンスのもとで公開されています。