深度目录树 MCP

一个模型上下文协议 (MCP) 实现，提供深度目录树可视化功能。该工具能够高效地可视化复杂的目录结构，通过 AI 驱动的文件系统结构分析增强开发工作流程。与任何支持 MCP 的客户端或 AI 助手兼容。

<a href="https://glama.ai/mcp/servers/deep-directory-tree"><img width="380" height="200" src="https://glama.ai/mcp/servers/deep-directory-tree/badge" alt="Deep Directory Tree MCP server" /></a>

快速开始

通过 Smithery 安装

要通过 Smithery 自动安装 Deep Directory Tree MCP：

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

手动安装

1. 前提条件

   • Bun 运行时

2. 安装

   # 全局安装
   bun install -g deep-directory-tree-mcp
   
   # 或者本地安装
   git clone https://github.com/andredezzy/deep-directory-tree-mcp.git
   cd deep-directory-tree-mcp
   bun install
   

3. 添加到 Claude 的 MCP 配置 将以下内容添加到您的 Claude 配置：

   {
     "name": "deep-directory-tree",
     "type": "mcp",
     "config": {
       "server": "https://glama.ai/mcp/servers/deep-directory-tree"
     }
   }
   

4. 启动服务器

   # 如果全局安装
   deep-directory-tree-mcp
   
   # 如果本地安装
   bun start
   

功能特性

• 深度目录树可视化
• 可配置的基于深度的树生成
• 基于模式的文件/目录排除
• 清晰易读的树输出格式

详细设置

本地开发设置

1. 克隆并安装：

   git clone https://github.com/andredezzy/deep-directory-tree-mcp.git
   cd deep-directory-tree-mcp
   bun install
   

2. 构建并运行：

   # 带有热重载的开发模式
   bun dev
   
   # 生产模式
   bun build
   bun start
   

故障排除

1. 树可视化问题

   • 确保正确的文件权限
   • 检查工作区路径配置
   • 验证文件系统事件监听器是否处于活动状态

2. 权限问题

   • 使用适当的用户权限运行
   • 检查文件系统访问权限
   • 验证工作区目录权限

3. 运行时问题

   • 确保 Bun 已安装并为最新版本：

     curl -fsSL https://bun.sh/install | bash
     bun upgrade
     

项目结构

deep-directory-tree-mcp/
├── src/              # 源代码
│   └── index.ts      # 主要应用程序入口点
├── .gitignore        # Git 忽略规则
├── bun.lock          # Bun 锁定文件
├── eslint.config.js  # ESLint 配置
├── index.ts          # 根入口点
├── package.json      # 项目配置和依赖项
├── smithery.yaml     # Smithery 配置
└── tsconfig.json     # TypeScript 配置

脚本

• bun build - 构建项目
• bun start - 运行生产服务器
• bun dev - 启动带有热重载的开发服务器

贡献

1. Fork 仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

MIT 许可证 - 详细信息请参阅 LICENSE 文件。

支持

如需支持：

• 在 GitHub 仓库中打开一个 issue
• 查看 FAQ