mcpField
F
Filesystem MCP Server

Filesystem MCP Server

本地服务
github.com/optistar文件与存储084 周前更新
代码仓库

关于 Filesystem MCP Server

这是一个基于 Anthropic 参考实现的 Go 版文件系统 MCP 服务，提供文件与目录工具，并支持以 JSON 返回元数据和目录树，以及在搜索中使用 gitignore 风格的排除模式。

主要功能

  1. 01创建、移动和编辑文件
  2. 02读取单个或多个文件
  3. 03列出目录和允许访问的路径
  4. 04以 JSON 返回目录树
  5. 05以 JSON 返回文件元数据
  6. 06搜索时使用 gitignore 风格排除模式

适用场景

  1. 01查看目录内容和元数据
  2. 02通过 MCP 读取或更新文件
  3. 03搜索文件并排除匹配路径

MCP 相关

向 MCP 客户端提供文件系统操作工具，包括读取、写入、编辑、移动、列出和搜索文件及目录。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

文件系统 MCP 服务

这是一个用于文件系统操作的模型上下文协议（MCP）服务的 Go 实现，基于 Anthropic 在 modelcontextprotocol/servers 中提供的参考实现。

与参考实现的主要区别包括：

  • get_file_info 和 directory_tree 命令会返回 JSON 数据。
  • search_files 工具支持 gitignore 风格的排除模式。

安装

使用以下命令安装服务：

go install github.com/optistar/mcp-server-filesystem/cmd/mcp-server-filesystem@latest

可执行文件将安装到 Go bin 目录，通常为 ~/go/bin。 如果此目录不在 PATH 中，可能需要将其添加进去。

你也可以设置 GOBIN 环境变量来更改安装目录。

测试

项目包含完整的测试套件，以确保服务按预期运行。

  • 可以直接使用 go test 运行测试。
  • tester 命令会将测试套件打包为一个 MCP 客户端，可用于测试 MCP 服务命令或其他 MCP 服务实现。

工具

此服务提供以下工具来操作文件系统：

  • create_directory：创建新目录或确保目录存在。
  • directory_tree：以 JSON 结构获取文件和目录的递归树视图。
  • edit_file：对文本文件进行基于行的编辑。
  • get_file_info：获取文件或目录的详细元数据。
  • list_allowed_directories：返回此服务允许访问的目录列表。
  • list_directory：获取指定路径下所有文件和目录的详细列表。
  • move_file：移动或重命名文件和目录。
  • read_file：从文件系统读取文件的全部内容。
  • read_multiple_files：同时读取多个文件的内容。
  • search_files：递归搜索与模式匹配的文件和目录。
  • write_file：创建新文件，或使用新内容完全覆盖现有文件。

如需了解各工具的详细信息，请使用 inspector。

其他实现

此仓库与 mark3labs/mcp-filesystem-server 无关。

许可证

此仓库中的代码根据 MIT 许可证发布。

评论

支持 Markdown

第一次接触 MCP？

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

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