BetterMCPFileServer
2025.03.15
0
TypeScript文件管理隐私保护LLM优化文件管理
BetterMCPFileServer是一个重新设计的模型上下文协议（MCP）文件服务器，专注于简化、隐私保护和效率。它通过路径别名系统保护用户隐私，隐藏完整的系统路径，同时提供优化的LLM友好API。核心功能包括路径别名系统、LLM优化的接口、智能搜索和隐私优先设计。适用于需要安全、高效文件系统访问的场景，特别是与大型语言模型（LLM）交互的应用。
View on GitHub
Overview
基本能力
产品定位
BetterMCPFileServer是一个专为文件系统访问优化的MCP服务器，特别注重隐私保护和LLM友好性。
核心功能
- 路径别名系统：保护隐私，隐藏完整系统路径
- LLM优化接口：从11个函数减少到6个，保持完整功能
- 智能搜索：统一目录列表和复杂文件搜索
- 隐私优先设计：不向AI模型暴露用户名或系统路径
适用场景
- 需要安全文件系统访问的LLM应用
- 隐私敏感的文件操作场景
- 需要简化文件系统接口的开发项目
工具列表
writeFile：创建或更新文件内容readFileContent：读取文件内容editFile：对文件进行针对性修改manageFile：移动、重命名、复制或删除文件manageFolder：创建、重命名或删除文件夹searchFilesAndFolders：使用glob模式搜索文件和文件夹
常见问题解答
- 错误：无效的别名:路径格式：确保每个参数使用
alias:directory格式 - 错误：目录不存在：指定的目录必须存在
- 访问被拒绝错误：尝试访问允许目录之外的内容
- 未知别名：引用的别名未在服务器启动时定义
使用教程
使用依赖
需要安装Node.js和npm。
安装教程
# 从源代码安装（npm包即将推出）
git clone https://github.com/martinschlott/BetterMCPFileServer.git
cd BetterMCPFileServer
npm install
npm run build
# 可选：使命令全局可用
npm link
调试方式
启动服务器并测试基本功能：
# 启动服务器
BetterMCPFileServer code:~/projects docs:~/documents
# 测试基本功能
# 列出可用别名
searchFilesAndFolders({ pattern: "*" })
# 读取文件
readFileContent({ filePath: "projects/README.md" })
# 写入文件
writeFile({
filePath: "projects/notes.txt",
content: "测试内容"
})