AI导哈

文件夹结构MCP服务器

一个轻量级、快速的模型上下文协议(MCP)服务器，用于生成美观、可读的树状文件夹结构，包括文件大小和智能文件类型描述，适用于为LLM提供项目布局的完整上下文。

  • by RayenMalouche
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 RayenMalouche/Folder-Structure-MCP-Server

使用说明

文件夹结构MCP服务器

轻便、快速 模型上下文协议（MCP） 该服务器生成具有文件大小和智能文件类型描述的美观、可读的树形文件夹结构，非常适合为LLM（如Claude、Cursor、Windsurf等）提供有关项目布局的完整上下文。

非常适合与 克劳德桌面, 光标或任何MCP兼容客户端。

my-project/
├── src/
│   ├── main/
│   │   ├── java/                  # Java source
│   │   └── resources/             # Config files
│   └── test/                      # Test sources
├── pom.xml                        # Maven POM
├── README.md                      # Markdown doc
└── .gitignore

特性

  • 生成任何目录的干净树视图
  • 显示人类可读的文件大小（KB、MB、GB…）
  • 自动为50多种常见文件类型添加有用的描述
  • 尊重 .gitignore-样式隐藏文件（可选）
  • 可配置的最大深度
  • 支持两者 工作室 和 HTTP/SSE 运输方式
  • 内置Spring Boot+Jetty+官方MCP SDK

快速入门（建议用于Claude Desktop）

1.构建JAR

git clone https://github.com/your-username/folder-structure-mcp-server.git
cd folder-structure-mcp-server
mvn clean package -DskipTests

这将创建两个JAR：

  • target/server-0.0.1-SNAPSHOT.jar → 常规JAR
  • target/server-0.0.1-SNAPSHOT-shaded.jar → fat/uber JAR（推荐）

这 阴影JAR 包含所有依赖项，最易于使用。

2.与Claude Desktop（或任何MCP客户端）一起使用

将此添加到您的 mcp.json 或Claude的工具配置：

{
  "mcpServers": {
    "folder-structure": {
      "command": "java",
      "args": [
        "-jar",
        "C:\\path\\to\\your\\folder-structure-mcp-server\\target\\server-0.0.1-SNAPSHOT-shaded.jar",
        "--stdio"
      ]
    }
  }
}

将路径替换为放置阴影JAR的位置。

现在你可以问克劳德这样的问题：

“显示当前项目的完整文件夹结构和文件描述”

或

“生成此项目的文件夹结构，包括隐藏文件，最大深度为20”

工具使用

工具名称： generate-folder-structure

参数：

参数 类型 必填 默认 说明
path string 是 - 扫描的绝对或相对路径
maxDepth integer 否 15 最大递归深度
showHidden boolean 否 false 包含点文件（如 .env, .git/)

聊天中的呼叫示例：

Please run generate-folder-structure on the current project directory with showHidden=true

generate-folder-structure /home/user/my-app maxDepth=10

手动运行

选项1:STDIO模式（适用于MCP客户端）

java -jar target/server-0.0.1-SNAPSHOT-shaded.jar --stdio

选项2:HTTP模式（用于测试或远程访问）

java -jar target/server-0.0.1-SNAPSHOT-shaded.jar
# → Starts on http://localhost:45451

或可流式传输HTTP模式：

java -jar target/server-0.0.1-SNAPSHOT-shaded.jar --streamable-http
# MCP endpoint: http://localhost:45451/message

📸 截图–克劳德桌面使用文件夹结构MCP服务器

以下是预览 克劳德桌面 连接到 文件夹结构MCP服务器，直接在聊天界面内生成完整的项目树。

屏幕截图显示 generate-folder-structure 工具成功运行，为Python游戏项目生成了一个干净的可视化文件夹树。

支持的文件描述（部分）

扩展 描述 扩展 描述
.java Java源代码 .py Python脚本
.ts/.tsx Types/React .js/.jsx JavaScript/RReact
.json JSON配置 .yaml YAML配置
.md Markdown文档 .xml XML配置
.png 图片 .pdf PDF文档
.dockerfile Docker配置 .sh Shell脚本

（还有更多！）

发展

# Run with hot reload (via Spring Boot)
mvn spring-boot:run

# Build shaded JAR
mvn clean package -DskipTests

需求

  • Java 21+
  • Maven（用于建筑）

许可证

麻省理工学院©2025 Rayen Malouche

旨在帮助人工智能更好地理解你的代码库——一次一棵树 🌳

相关 MCP