关于 Filesystem MCP Server
Filesystem MCP Server 向 MCP 客户端提供文件和目录信息及文件内容。它以资源形式提供元数据和内容,并提供目录列表工具;项目使用 Spring Framework 进行依赖注入。
主要功能
- 01获取文件和目录元数据
- 02读取文本与二进制文件内容
- 03根据扩展名检测 MIME 类型
- 04列出目录中的文件
- 05使用 Spring 依赖注入
适用场景
- 01查看文件和目录详情
- 02通过 MCP 客户端读取文件
- 03列出目录中的文件
MCP 相关
它将文件元数据和内容作为 MCP 资源公开,并提供用于列出目录内容的 `list_files` 工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
暂未收录安装方式
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
文件系统 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 配置类
- 服务层:用于文件系统操作的核心服务
- 资源层:用于公开文件系统功能的 MCP 资源
- 工具层:用于常见操作的工具类
依赖注入
该服务使用 Spring Framework 进行依赖注入,具有以下优点:
- 使用构造函数注入,提高可测试性
- 使用
@PostConstruct和@PreDestroy管理生命周期 - 使用配置类显式定义 Bean
- 使用组件扫描自动发现 Bean
许可证
本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。