本地文件MCP服务器
用于管理本地文件的模型上下文协议（MCP）服务器。提供具有内置安全保护的读取、写入、分析、搜索和组织文件的工具。
特性
- 📖 读取/写入文件 -UTF-8和base64支持
- 📂 目录操作 -列出、组织、搜索
- 🔍 内容搜索 -正则表达式模式匹配
- 🔎 查找重复项 -MD5哈希比较
- 📊 文件分析 -大小、MIME类型、行数
- 🛡️ 安全防护 -可配置的允许/保护路径
- 🖥️ 跨平台 -macOS、Linux、Windows
安装
NPX
添加到您的Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"local-files": {
"command": "npx",
"args": ["-y", "fsorg"]
}
}
}就是这样！Claude Desktop将通过npx自动下载并运行MCP服务器。
替代方案：从源代码安装
git clone https://github.com/argtobias/fsorg.git
cd fsorg
pnpm install
pnpm build然后配置Claude Desktop：
{
"mcpServers": {
"local-files": {
"command": "node",
"args": ["/path/to/fsorg/dist/index.js"]
}
}
}安全配置
在以下位置创建配置文件：
-- macOS/Linux: ~/.config/localfiles-org/config.json
-- 视窗: %LOCALAPPDATA%\localfiles-org\config.json
{
"allowedPaths": [
"~/projects",
"~/Development",
"~/workspace",
"/tmp"
],
"additionalProtectedPaths": [
"~/my-important-folder"
],
"additionalProtectedPatterns": [
"^backup",
"\\.bak$"
]
}配置选项
| 选项 | 描述 | 默认值 |
|---|---|---|
allowedPaths | 允许删除操作的路径 | ~/projects, ~/dev等等。 |
additionalProtectedPaths | 防止删除的额外路径 | [] |
additionalProtectedPatterns | 受保护文件名的正则表达式模式 | [] |
始终受保护（不能被覆盖）
- 系统路径:
/,/etc,/usr,/bin,/System等等。 - 用户路径:
~,~/Documents,~/Desktop,~/Downloads,~/.ssh - 模式:
.git,.env,.ssh、证书、秘密
可用工具
文件操作
| 工具 | 说明 |
|---|---|
read_file | 读取文件内容（UTF-8或base64） |
write_file | 将内容写入文件（UTF-8或base64） |
delete_file | 通过保护检查安全删除文件 |
move_file | 使用可选的空目录清理功能移动文件 |
analyze_file | 获取文件统计信息（大小、MIME、行、单词） |
目录操作
| 工具 | 说明 |
|---|---|
list_directory | 列出具有可选递归和glob模式的文件 |
delete_directory | 安全删除目录（需要确认递归） |
organize_by_type | 按扩展名/日期/大小将文件组织到文件夹中 |
搜索操作
| 工具 | 说明 |
|---|---|
search_content | 在文件内容中搜索正则表达式模式 |
find_duplicates | 通过MD5哈希查找重复文件 |
sort_file_content | 对文件中的行进行排序 |
批量操作
| 工具 | 说明 |
|---|---|
rename_files | 使用正则表达式模式批量重命名文件 |
用法示例
读取文件
{
"tool": "read_file",
"arguments": {
"path": "~/projects/myfile.txt"
}
}查找并删除重复项
{
"tool": "find_duplicates",
"arguments": {
"path": "~/projects/images",
"recursive": true
}
}使用预览安全删除
{
"tool": "delete_file",
"arguments": {
"path": "~/projects/temp/old-file.txt",
"preview": true
}
}按扩展名组织文件
{
"tool": "organize_by_type",
# Local Files MCP Server
Simple MCP server for safe local file operations: read, write, search, organize and protected delete.
## Quick install
Run via npx (recommended for Claude Desktop):
{ "mcpServers": { "local-files": { "command": "npx", "args": ["-y", "fsorg"] } } }
来源：
git clone https://github.com/argtobias/fsorg.git cd fsorg pnpm install pnpm build
## 配置
在以下位置创建用户配置：
- macOS/Linux： `~/.config/localfiles-org/config.json`
- 窗户： `%LOCALAPPDATA%\\localfiles-org\\config.json`
最小配置示例：
{ "allowedPaths": ["~/projects", "~/Development"], "additionalProtectedPaths": [], "additionalProtectedPatterns": [] }
## 安全
- 仅限内部操作 `allowedPaths` 可以删除文件。
- 系统和用户关键路径始终受到保护。
- 基于模式的保护（例如。 `.git`, `.env`)强制执行。
## 使用示例
读取文件：
{ "tool": "read_file", "arguments": { "path": "~/projects/myfile.txt" } }
查找重复项：
{ "tool": "find_duplicates", "arguments": { "path": "~/projects/images", "recursive": true } }
带预览删除（安全）：
{ "tool": "delete_file", "arguments": { "path": "~/projects/temp/old.txt", "preview": true } }
## 发展
pnpm install pnpm build pnpm dev
## 许可证
ISC