mcpField
F
Filesystem

Filesystem

本地服务
github.com文件与存储34 天前更新

关于 Filesystem

Filesystem 是用于读取、创建和编辑文件的 MCP 服务。其工具支持查看文件、覆盖写入、精确字符串替换和按行插入文本。

主要功能

  1. 01读取文件并列出目录
  2. 02创建或覆盖文件
  3. 03替换精确字符串
  4. 04在指定行插入文本

适用场景

  1. 01将邮件附件保存到文件夹
  2. 02更新配置项
  3. 03将日历摘要写入笔记
  4. 04重构文件中的函数名

MCP 相关

Filesystem 向 MCP 客户端提供文件读取和编辑工具,包括 view、create、str_replace 和 insert。

配置

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

mcp.json · 通用配置
{
"mcpServers": {
"domdomegg-filesystem": {
"command": "npx",
"args": [
"-y",
"filesystem-mcp"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>"
}
}
}
}
启动命令npx -y filesystem-mcp
需要配置的环境变量
MCP_TRANSPORTTransport type.

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmfilesystem-mcp1.3.0

工具

还没有获取到工具列表

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

详细介绍

filesystem-mcp

用于文件系统操作的 MCP 服务——读取、创建和编辑文件。

使用场景

保存电子邮件附件:“下载我这个月收到的会计师邮件中的所有 PDF” → 搜索符合条件的 Gmail 邮件,提取附件,并将其保存到本地文件夹。

更新配置文件:“将我的配置中的 API 端点从 staging 改为 production” → 查找配置文件,替换 URL,并显示差异。

生成报告:“创建今天日历事件的摘要” → 读取日历,生成 Markdown 报告,并将其保存到笔记文件夹。

代码重构:“将 src/api.ts 中的函数 getData 重命名为 fetchUserData” → 读取文件,进行精确替换,并确认更改。

更改前备份:“在修改 .zshrc 之前保存一份副本” → 读取当前文件,并写入带时间戳的备份。

设置

请按照 install-mcp 上的说明操作,该页面会为你的 MCP 客户端(Claude Code、Claude Desktop、Cursor、Cline、VS Code 等)生成合适的配置。

工具

工具描述
view读取文件内容或列出目录(带行号)
create创建或覆盖文件
str_replace替换文件中的精确字符串
insert在指定行插入文本

贡献

欢迎在 GitHub 上提交拉取请求!开始贡献:

  1. 安装 Git 和 Node.js
  2. 克隆代码库
  3. 使用 npm install 安装依赖
  4. 运行 npm run test 执行测试
  5. 使用 npm run build 构建

发布

版本遵循语义化版本规范。

发布步骤:

  1. 使用 npm version <major | minor | patch> 更新版本号
  2. 运行 git push --follow-tags 推送并附带标签
  3. 等待 GitHub Actions 发布到 NPM 注册表。

评论

支持 Markdown

第一次接触 MCP?

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

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