mcpField
F
Filesystem MCP Server

Filesystem MCP Server

本地服务
github.com/jayessdeesea文件与存储083 周前更新

关于 Filesystem MCP Server

Filesystem MCP Server 向 MCP 客户端提供文件和目录信息及文件内容。它以资源形式提供元数据和内容,并提供目录列表工具;项目使用 Spring Framework 进行依赖注入。

主要功能

  1. 01获取文件和目录元数据
  2. 02读取文本与二进制文件内容
  3. 03根据扩展名检测 MIME 类型
  4. 04列出目录中的文件
  5. 05使用 Spring 依赖注入

适用场景

  1. 01查看文件和目录详情
  2. 02通过 MCP 客户端读取文件
  3. 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

文档

架构

该服务采用分层架构:

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

依赖注入

该服务使用 Spring Framework 进行依赖注入,具有以下优点:

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

许可证

本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。