关于 Filesystem
Filesystem 是用于读取、创建和编辑文件的 MCP 服务。其工具支持查看文件、覆盖写入、精确字符串替换和按行插入文本。
主要功能
- 01读取文件并列出目录
- 02创建或覆盖文件
- 03替换精确字符串
- 04在指定行插入文本
适用场景
- 01将邮件附件保存到文件夹
- 02更新配置项
- 03将日历摘要写入笔记
- 04重构文件中的函数名
MCP 相关
Filesystem 向 MCP 客户端提供文件读取和编辑工具,包括 view、create、str_replace 和 insert。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
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 上提交拉取请求!开始贡献:
- 安装 Git 和 Node.js
- 克隆代码库
- 使用
npm install安装依赖 - 运行
npm run test执行测试 - 使用
npm run build构建
发布
版本遵循语义化版本规范。
发布步骤:
- 使用
npm version <major | minor | patch>更新版本号 - 运行
git push --follow-tags推送并附带标签 - 等待 GitHub Actions 发布到 NPM 注册表。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。