Deep Directory Tree MCP

🚀 深度目录树 MCP 🌳

このツールは、強力なモデルコンテキストプロトコル（MCP）の実装で、ディレクトリ構造の可視化と分析に役立ちます。AI アシスタントがプロジェクト構造を効率的に理解し、ナビゲートできるようになり、よりスマートなコードナビゲーションとプロジェクト組織の洞察を得ることができます。

このツールは以下の技術を使用して構築されています：

• Anthropic MCP
• Cursor

✨ 主な機能

• 深度ディレクトリツリーの可視化
• 可設定な深さでのツリー生成
• ファイル/ディレクトリの除外に基づくスマートモード
• クリーンで読みやすいツリー出力形式
• リアルタイムのディレクトリ構造更新
• ディレクトリに対するスマート分析

DEMO：

🚀 クイックスタート

前提条件

• Node.js（v18 以上）

Smithery を使用したインストール

Smitheryを使用するのが最も簡単な方法です：

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

手動インストール

Cursor IDE の設定

1. Cursor の設定 → MCP → 新しい MCP サーバーを追加
2. 以下の設定を使用します：

{
  "deep-directory-tree": {
    "command": "npx",
    "args": ["-y", "@andredezzy/deep-directory-tree-mcp"]
  }
}

Claude Desktop の設定

以下の内容を MCP 設定に追加します：

{
  "mcpServers": {
    "deep-directory-tree": {
      "command": "npx",
      "args": ["-y", "@andredezzy/deep-directory-tree-mcp"]
    }
  }
}

💻 使用例

AI アシスタントでよく使うコマンド：

• “ディレクトリ構造を表示”
• “プロジェクトツリーを深さ 4 まで可視化”
• “テストディレクトリのファイルを除外”

🔧 開発

前提条件

• Bun Runtime（必須）

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

# 依存関係をインストール
bun install

# プロジェクトをビルド
bun run build

開発用の手動インストール

Cursor IDE の設定

1. Cursor の設定 → MCP → 新しい MCP サーバーを追加
2. 以下の設定を使用します：

{
  "deep-directory-tree": {
    "command": "node",
    "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/bin/deep-directory-tree.js"]
  }
}

Claude Desktop の設定

以下の内容を MCP 設定に追加します：

{
  "mcpServers": {
    "deep-directory-tree": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/bin/deep-directory-tree.js"]
    }
  }
}

🤝 コントリビューションガイド

問題の報告とフィードバック

• 何か問題があった場合は、Issuesに報告してください。
• 提案や機能要求があれば、遠慮なく提出してください。

ブランチの作成

• リポジトリをクローンした後、新しい機能ブランチを作成します：

git checkout -b feature/new-feature

• 変更をコミットし、そのブランチにプッシュします。
• メインブランチへのプルリクエストを作成します。

🤗 サポート

このプロジェクトが役に立った場合は、サポートを検討してください。以下の方法でサポートできます：

• リポジトリにスターを付ける：プロジェクトへの認識を示します。
• フィードバックを提供する：プロジェクトの改善に役立ちます。
• コードを貢献する：プロジェクトの開発に参加します。

ご支援いただき、ありがとうございます！