文件系统 MCP 服务器

一个提供访问文件元数据和内容的 MCP 服务器。

概述

文件系统 MCP 服务器是一个模型上下文协议 (MCP) 服务器，它提供访问文件元数据和内容的资源。它允许客户端检索有关文件和目录的信息，以及读取文件的内容。

特性

• 获取文件和目录的元数据（名称、路径、大小、时间戳、权限等）
• 读取文本和二进制文件的内容
• 基于文件扩展名的自动 MIME 类型检测
• 全面的日志记录
• 使用 Spring Framework 进行依赖注入，以实现更好的可维护性和可测试性

资源

服务器提供以下资源：

• file://metadata/{path} - 获取文件或目录的元数据
• file://content/{path} - 获取文件的内容

有关更多信息，请参阅资源文档。

工具

服务器提供以下工具：

• list_files - 列出目录中的文件

有关更多信息，请参阅工具文档。

构建和运行

前提条件

• Java 17 或更高版本
• Maven
• Spring Framework（由 Maven 自动管理）

构建

mvn clean package

这将在 target 目录中创建一个可执行的 JAR 文件。

运行

java -jar target/filesystem-mcp-1.0-SNAPSHOT-jar-with-dependencies.jar

文档

• 资源
• 工具
• 提示
• Spring 集成
• Spring 最佳实践
• Dagger2 到 Spring 迁移
• Dagger2 最佳实践（供参考）

架构

服务器使用分层架构：

1. 配置层: 用于依赖注入的 Spring 配置类
2. 服务层: 用于文件系统操作的核心服务
3. 资源层: 用于公开文件系统功能的 MCP 资源
4. 实用程序层: 用于常见操作的实用程序类

依赖注入

服务器使用 Spring Framework 进行依赖注入，它提供：

• 构造函数注入，以实现更好的可测试性
• 使用 @PostConstruct 和 @PreDestroy 进行生命周期管理
• 用于显式 bean 定义的配置类
• 用于自动 bean 发现的组件扫描

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。