<div align="center">

文件系统MCP 📁

为AI代理提供安全的文件系统操作 - 优化批量处理和令牌使用

批量操作 • 项目根目录安全性 • 令牌优化 • Zod验证

快速开始 • 安装 • 工具

<a href="https://glama.ai/mcp/servers/@sylphlab/filesystem-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@sylphlab/filesystem-mcp/badge" alt="文件系统MCP服务器" /> </a> </div>

---

🚀 概述

赋予您的AI代理（如Claude/Cline）安全、高效且节省令牌访问项目文件的能力。此Node.js服务器实现了模型上下文协议（MCP），以提供强大的文件系统工具集。

问题：

传统的AI文件系统访问：
- 每次操作使用Shell命令 ❌
- 没有批量处理（高令牌成本）❌
- 不安全（没有项目根边界）❌
- 高延迟（Shell启动开销）❌

解决方案：

文件系统MCP服务器：
- 批量操作（一次处理10+个文件）✅
- 令牌优化（减少往返次数）✅
- 安全（限制在项目根目录内）✅
- 直接API（无Shell开销）✅

结果：为AI代理提供安全、快速且节省令牌的文件系统操作。

---

⚡ 性能优势

令牌与延迟优化

指标	单独Shell命令	文件系统MCP	改善
每请求操作数	1个文件	10+个文件	减少10倍
往返次数	N次操作	1次请求	减少N倍
延迟	每次操作启动Shell	直接API	快5-10倍
令牌使用	高开销	批量上下文	减少50-70%
错误报告	解析stderr	每项状态	详细

实际好处

• 批量文件读取 - 一次请求读取10个文件，而不是10次请求
• 多文件编辑 - 使用单个工具调用编辑多个文件
• 递归操作 - 高效列出整个目录树
• 详细状态 - 每项成功/失败报告

---

🎯 为什么选择这个服务器？

安全性与安全性

• 🛡️ 项目根目录限制 - 所有操作限制在启动时的当前工作目录（cwd）
• 🔒 权限控制 - 内置chmod/chown工具
• ✅ 验证 - Zod模式验证所有参数
• 🚫 防止路径遍历 - 无法逃离项目目录

效率与性能

• ⚡ 批量处理 - 每次请求处理多个文件/目录
• 🎯 令牌优化 - 减少AI服务器通信开销
• 🚀 直接API - 无需启动Shell进程
• 📊 详细结果 - 批量操作的每项状态

开发者体验

• 🔧 简单设置 - 使用npx/bunx即时使用
• 🐳 Docker就绪 - 提供官方Docker镜像
• 📦 综合工具 - 11+个文件系统操作
• 🔄 MCP标准 - 全面符合协议

---

📦 安装

方法1：npx/bunx（推荐）

最简单的方式 - 始终使用npm上的最新版本。

使用npx：

{
  "mcpServers": {
    "filesystem-mcp": {
      "command": "npx",
      "args": ["@sylphlab/filesystem-mcp"],
      "name": "文件系统（npx）"
    }
  }
}

使用bunx：

{
  未完待续...
}