AI导哈

本地文件管理服务器

一个用于管理本地文件的MCP服务器，提供读取、写入、分析、搜索和组织文件的工具，内置安全保护功能。

  • by TobiasArg
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 TobiasArg/LocalFilesOrganizer-MCP

使用说明

本地文件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):

  ```json
  {
    "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

相关 MCP