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

参数：

聊天中的呼叫示例：

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游戏项目生成了一个干净的可视化文件夹树。

支持的文件描述（部分）

（还有更多！）

发展

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

# Build shaded JAR
mvn clean package -DskipTests

需求

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

许可证

麻省理工学院©2025 Rayen Malouche

______________________________________________________________________

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