🚀 深度目录树 MCP 🌳
一个强大的模型上下文协议（MCP）实现，用于可视化和分析目录结构。借助它，AI 助手能高效理解并导航你的项目结构，进而实现更智能的代码导航和项目组织洞察。
✨ 主要特性
- 深度目录树可视化
- 可配置深度的树生成
- 智能模式基于文件/目录排除
- 清洁可读的树输出格式
- 实时目录结构更新
- 针对目录的智能分析
DEMO：
🚀 快速开始
先决条件
- Node.js（v18 或更高版本）
Smithery 安装
使用Smithery最简单的方式：
npx -y @smithery/cli install @andredezzy/deep-directory-tree-mcp --client cursor
手动安装
Cursor IDE 设置
- 打开 Cursor 设置 → MCP → 添加新的 MCP 服务器
- 使用以下配置设置：
{
"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 设置
- 打开 Cursor 设置 → MCP → 添加新的 MCP 服务器
- 使用以下配置设置：
{
"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
- 提交你的更改并推送到该分支。
- 创建拉取请求到主分支。
支持
如果你发现这个项目对你有帮助，请考虑支持它。你可以通过以下方式提供支持：
- 星标仓库：表示你对项目的认可。
- 提供反馈：帮助改进项目。
- 贡献代码：参与项目开发。
感谢你的支持！