Deep Directory Tree MCP

🚀 深度目錄樹 MCP 🌳

深度目錄樹 MCP 是一個強大的模型上下文協議（MCP）實現，可用於可視化和分析目錄結構。藉助該工具，AI 助手能夠高效理解並導航項目結構，進而實現更智能的代碼導航和項目組織洞察。

🚀 快速開始

先決條件

• 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"]
    }
  }
}

✨ 主要特性

• 深度目錄樹可視化
• 可配置深度的樹生成
• 智能模式基於文件/目錄排除
• 清潔可讀的樹輸出格式
• 即時目錄結構更新
• 針對目錄的智能分析

DEMO：

💻 使用示例

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

• 提交你的更改並推送到該分支。
• 創建拉取請求到主分支。

🫶 支持

如果你發現這個項目對你有幫助，請考慮支持它。你可以通過以下方式提供支持：

• 星標倉庫：表示你對項目的認可。
• 提供反饋：幫助改進項目。
• 貢獻代碼：參與項目開發。

感謝你的支持！