mcp-server-prototype

🚀 文件系统 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 - 列出目录中的文件

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

架构

服务器采用分层架构：

1. 配置层：用于依赖注入的 Spring 配置类
2. 服务层：核心服务，处理文件系统操作
3. 资源层：MCP 资源，用于暴露文件系统功能
4. 工具层：通用操作的辅助类

依赖注入

服务器使用 Spring 框架进行依赖注入，提供以下优势：

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