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