用途
ellmos FileCommander MCP Server 是一个综合性的本地文件系统 MCP（Model Context Protocol）服务器，旨在为 AI 助手提供对本地系统的完整访问能力。与多数仅覆盖基础读写的文件系统 MCP 服务器不同，FileCommander 在单个服务器中集成了 50 个工具，覆盖文件操作、内容搜索、进程管理、交互式会话、格式转换、文档导出等方面。
主要能力
文件系统操作（15 个工具） 包括文件读取、写入、移动、复制等。其中 fc_preview_file 是本地文件的远程/无头回退方案，默认调用仅返回结构化元数据（解析路径、file:// URI、MIME 类型、字节大小、预览类型、固定 1 MiB 上限及后续调用建议）；只有在 include_content=true 后才读取内容。超过 1 MiB 的文件和不支持的类型保持仅元数据模式，不会读取或 Base64 编码。
内容搜索（1 个工具） fc_search_content 不展开通配符、不遍历目录、不递归发现文件。它最多接受 50 个显式 UTF-8 文本文件，跳过二进制和超过 10 MB 的文件，返回确定性 JSON。全局最多 200 个匹配、每文件 100 个匹配、上下文 10 行、摘录 500 字符、序列化输出 200,000 字符。缺失、仅云端、权限、编码、二进制和大小错误按文件报告，可读文件仍能产出结果，且常见密钥格式会在摘录中被脱敏。
异步搜索（5 个工具） 支持在 AI 继续工作的同时于后台搜索大型目录树，并提供分页与令牌管理。
进程管理（5 个工具） 可列出、启动、终止系统进程。fc_execute_command 接受任意 shell 命令（普通命令使用 Node 默认 shell，Windows 上为 cmd.exe；Windows 特殊字符路径可路由至 Windows PowerShell）。fc_start_process 允许调用者选择可执行文件和参数。fc_open_path 只接受已存在的文件或目录，并交给固定的本机默认处理程序启动器，其结果始终将 user_visible 报告为 "unknown"。
交互式会话（5 个工具） 通过 MCP 协议启动并与 REPL（Python、Node.js、Shell 等）交互，使用有界环形缓冲区。
其他工具 文件维护与修复（9 个，含字符串替换、JSON 修复、Mojibake 编码修复、重复检测）、归档（1 个，ZIP 创建/解压/列出）、云同步（1 个）、系统（4 个）、导出（2 个，Markdown 转 HTML/PDF）。此外支持格式转换（fc_convert_format，在 JSON、YAML、TOML、XML、CSV、INI、TOON 之间无损转换）、校验和（fc_checksum，支持 MD5、SHA-1、SHA-256、SHA-384、SHA-512）以及 OCR（可选 tesseract.js 依赖）。
使用方式
需要 Node.js 20 或更高版本。可通过 NPM 安装（包名 ellmos-filecommander 对应的 npm 页面，资料中未提供具体安装命令文本），或从源码安装。服务器通过 stdio 传输通信；在 Claude Desktop 中需在 claude_desktop_config.json 添加配置（Windows 路径为 %APPDATA%\Claude\claude_desktop_config.json，macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json），保存后重启应用。其他 MCP 客户端可将入口指向 dist/index.js 或 ellmos-filecommander 二进制文件。
适用场景
- 自主 AI 编码代理与 LLM 集群：多代理集群和单体代理运行时（如 Claude Code、Gemini、OpenAI Codex、AutoGen、CrewAI）执行递归代码编辑、项目重构和目录审计时，避免上下文窗口膨胀、云同步文件夹中的文件锁导致的进程崩溃，以及误删导致的仓库损坏。
- DevOps 与多主机自动化工程师：构建跨平台 CLI 工具、CI/CD 验证流水线和多机同步脚本，统一 Windows、Linux、macOS 语义。
- 安全运营与合规人员：需要本地 stdio 传输、零遥测、零开放网络监听端口，并对搜索摘录中的密钥和令牌进行自动脱敏。
- 企业平台架构师与数据管道开发者：整合本地文件、规范化异构配置格式、验证加密哈希并生成报告。
限制
- 服务器拥有与运行用户权限相同的完整文件系统访问权限。
- fc_execute_command 可运行任意 shell 命令；fc_open_path 会调用操作系统关联的应用程序。
- 出站网络出口严格限于调用方主动触发的 fc_web_fetch，内部/私有 IP 默认被阻止。
- 部分第三方目录仍显示旧的 43 工具元数据，官方 README/npm 元数据为准。
- 具体安装命令、配置代码、定价、平台兼容性细节等在资料中未完整提供，需以官方仓库为准。
