🚀 文件系统 MCP 服务器
文件系统 MCP 服务器是一个模型上下文协议（MCP）服务器，可提供文件元数据和内容的访问资源，让客户端能检索文件和目录信息，还能读取文件内容。
🚀 快速开始
文件系统 MCP 服务器是一个模型上下文协议（MCP）服务器，可提供用于访问文件元数据和内容的资源。客户端能通过它检索有关文件和目录的信息，还能读取文件内容。
✨ 主要特性
- 获取文件和目录的元数据（名称、路径、大小、时间戳、权限等）
- 读取文本文件和二进制文件的内容
- 基于文件扩展名的自动 MIME 类型检测
- 全面日志记录
- 使用 Spring 框架进行依赖注入，以提高维护性和测试性
📦 安装指南
先决条件
- Java 17 或更高版本
- Maven
- Spring 框架（由 Maven 自动管理）
构建
mvn clean package
这将在 target 目录下创建一个可执行的 JAR 文件。
运行
java -jar target/filesystem-mcp-1.0-SNAPSHOT-jar-with-dependencies.jar
📚 详细文档
- 资源
- 工具
- 提示
- Spring 集成
- Spring 最佳实践
- 从 Dagger2 迁移到 Spring
- Dagger2 最佳实践（供参考）
🔧 技术细节
资源
该服务器提供的资源如下：
file://metadata/{path}- 获取文件或目录的元数据file://content/{path}- 获取文件内容
有关更多详细信息，请参阅资源文档。
工具
该服务器提供的工具如下：
list_files- 列出目录中的文件
有关更多信息，请参阅工具文档。
架构
服务器采用分层架构：
- 配置层：用于依赖注入的 Spring 配置类
- 服务层：核心服务，处理文件系统操作
- 资源层：MCP 资源，用于暴露文件系统功能
- 工具层：通用操作的辅助类
依赖注入
服务器使用 Spring 框架进行依赖注入，提供以下优势：
- 使用构造函数注入以提高可测试性
- 使用
@PostConstruct和@PreDestroy进行生命周期管理 - 使用配置类进行显式 Bean 定义
- 自动发现组件扫描