ellmos文件命令MCP服务器
🇩🇪 德语版
*部分 埃尔莫斯 家庭。*
 ](https://www.npmjs.com/package/ellmos-filecommander-mcp) ](https://nodejs.org/)
全面的 模型上下文协议(MCP)服务器 这为AI助手提供了完整的文件系统访问、进程管理、交互式shell会话和异步文件搜索功能。
43工具 在单个服务器中,AI代理与本地系统交互所需的一切。
______________________________________________________________________
为什么选择FileCommander?
大多数文件系统MCP服务器只覆盖基本的读/写操作。FileCommander更进一步:
- 安全删除 -将文件移动到回收站(Windows)或回收站(macOS/Linux),而不是永久删除
- 交互式会话 -通过MCP协议启动REPL(Python、Node.js、shell)并与之交互
- 异步搜索 -在AI继续工作的同时在后台搜索大型目录树
- 进程管理 -列出、启动和终止系统进程
- 字符串替换 -通过将唯一字符串与上下文验证相匹配来编辑文件
- 格式转换 -在JSON、CSV、INI、YAML、TOML、XML和TOON之间转换
- ZIP档案 -创建、提取和列出ZIP存档
- 文件校验和 -SHA-256、MD5、SHA-1、SHA-512哈希与比较
- 光学字符识别 -从图像中提取文本(可选的tesseract.js依赖项)
- 安全模式 -切换以通过回收站/废纸篓路由所有删除
- Markdown导出 -使用代码块、表格、嵌套列表、区块引用将Markdown转换为专业HTML/PDF
- 跨平台 -适用于Windows、macOS和Linux,并具有特定于平台的优化
______________________________________________________________________
安装
先决条件
- 18岁或以上
- npm
选项1:从NPM安装
npm install -g ellmos-filecommander-mcp选项2:从源代码安装
git clone https://github.com/ellmos-ai/ellmos-filecommander-mcp.git
cd ellmos-filecommander-mcp
npm install
npm run build______________________________________________________________________
配置
克劳德桌面版
添加到您的 claude_desktop_config.json:
窗户: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
如果通过NPM全局安装:
{
"mcpServers": {
"filecommander": {
"command": "ellmos-filecommander"
}
}
}如果从源代码安装:
{
"mcpServers": {
"filecommander": {
"command": "node",
"args": ["/absolute/path/to/filecommander-mcp/dist/index.js"]
}
}
}保存后重新启动Claude Desktop。
其他MCP客户端
服务器通过以下方式进行通信 stdio传输.将您的MCP客户端指向 dist/index.js 入口点或 ellmos-filecommander 二元的。
______________________________________________________________________
工具概述
文件系统操作(14个工具)
| 工具 | 说明 |
|---|---|
fc_read_file | 读取具有可选行限制的文件内容 |
fc_read_multiple_files | 一次通话最多可读取20个文件 |
fc_write_file | 写入/创建/附加到文件 |
fc_edit_file | 基于行的编辑(替换、插入、删除行) |
fc_str_replace | 用上下文验证替换文件中的唯一字符串 |
fc_list_directory | 列出目录内容(递归,可配置深度) |
fc_create_directory | 创建目录(包括父目录) |
fc_delete_file | 删除文件(永久) |
fc_delete_directory | 删除目录(带可选递归标志) |
fc_safe_delete | 移至回收站/废纸篓(可恢复!) |
fc_move | 移动或重命名文件和目录 |
fc_copy | 复制文件和目录 |
fc_file_info | 获取详细的文件元数据(大小、日期、类型) |
fc_search_files | 使用通配符模式进行同步文件搜索 |
异步搜索(5个工具)
| 工具 | 说明 |
|---|---|
fc_start_search | 开始背景搜索(立即返回) |
fc_get_search_results | 使用分页检索结果 |
fc_stop_search | 取消正在进行的搜索 |
fc_list_searches | 列出所有活动/已完成的搜索 |
fc_clear_search | 从内存中删除已完成的搜索 |
过程管理(4个工具)
| 工具 | 说明 |
|---|---|
fc_execute_command | 执行shell命令(阻塞,带超时) |
fc_start_process | 启动后台进程(非阻塞) |
fc_list_processes | 列出正在运行的系统进程 |
fc_kill_process | 按PID或名称终止进程 |
互动会议(5个工具)
| 工具 | 说明 |
|---|---|
fc_start_session | 启动一个交互式进程(Python、Node、shell……) |
fc_read_output | 读取会话输出 |
fc_send_input | 向正在运行的会话发送输入 |
fc_list_sessions | 列出所有会话 |
fc_close_session | 终止会话 |
文件维护与修复(8个工具)
| 工具 | 说明 |
|---|---|
fc_fix_json | 修复损坏的JSON(BOM、尾随逗号、注释、单引号) |
fc_validate_json | 使用详细的错误位置和上下文验证JSON |
fc_cleanup_file | 删除BOM、NUL字节、尾随空格,规范行尾 |
fc_fix_encoding | 修复Mojibake/双编码UTF-8(27+字符模式) |
fc_folder_diff | 使用快照跟踪目录更改(新建/修改/删除) |
fc_batch_rename | 基于模式的批量重命名(前缀/后缀、替换、自动检测) |
fc_convert_format | 在JSON、CSV、INI、YAML、TOML、XML和TOON格式之间转换 |
fc_detect_duplicates | 使用SHA-256哈希查找重复文件 |
fc_checksum | 文件哈希(MD5、SHA-1、SHA-256、SHA-512),可选比较 |
存档(1个工具)
| 工具 | 说明 |
|---|---|
fc_archive | 创建、提取和列出ZIP存档 |
OCR(1个工具)
| 工具 | 说明 |
|---|---|
fc_ocr | 通过tesseract.js从图像中提取文本(可选依赖项) |
系统(2个工具)
| 工具 | 说明 |
|---|---|
fc_get_time | 使用时区信息获取当前系统时间 |
fc_set_safe_mode | 切换安全模式:所有删除都通过回收站/废纸篓 |
导出(2个工具)
| 工具 | 说明 |
|---|---|
fc_md_to_html | Markdown到具有CSS样式的独立HTML(标题、代码块、表格、嵌套列表、块引号、图像、复选框) |
fc_md_to_pdf | 通过无头浏览器(Edge/Chrome)将Markdown转换为PDF。如果没有可用的浏览器,则回退到HTML |
总计:43个工具
______________________________________________________________________
与备选方案的比较
|---------|:---:|:---:|:---:| |文件读/写/复制/移动|14个工具|是|是| |安全删除(回收站)|是|否|否| |异步背景搜索|5个工具|否|否| |交互式会话(REPL)|5个工具|是|否| |流程管理|4个工具|是|否| |Shell命令执行|是|是|否| |字符串替换为验证|是|是|否| |基于行的文件编辑|是|否|否| |JSON修复和验证|2个工具|否|否| |编码修复(Mojibake)|是|否|否| |重复检测(SHA-256)|是|否|否| |文件夹差异/更改跟踪|是|否|否| |批量重命名(基于模式)|是|否|否| |格式转换(JSON/CSV/INI/YAML/TOML/XML/TON)|是|否|否| |ZIP存档(创建/提取/列表)|是|否|否| |文件校验和(SHA-256/MD5)|是|否|否| |OCR(图像到文本)|可选|否|否| |安全模式(删除→ 回收站)|是|否|否| |路径分配/沙盒|否|否|是| |Excel/PDF支持| PDF(通过浏览器)|是|否| |HTTP传输|否|否|不| |Markdown到HTML/PDF导出|是|否|否| | 工具总数 | 43 | ~15 | ~11 | | 需要服务器 | 1 |1|+流程额外费用|
主要差异化因素:
- 仅MCP服务器具有 可恢复删除 (回收站/垃圾桶)
- 仅MCP服务器具有 异步背景搜索 分页
- 内建 JSON修复, 编码修复,以及 重复检测
- 最全面的单服务器解决方案(43个工具)
- 内建 安全模式 防止意外永久删除
______________________________________________________________________
工具前缀
所有工具都使用 fc_ 前缀(FileCommander)以避免与其他MCP服务器冲突。
______________________________________________________________________
安全
此服务器具有运行用户的完全文件系统访问权限。
看 安全.md 获取详细的安全信息和建议。
要点:
fc_execute_command运行任意shell命令fc_delete_*默认情况下,工具执行永久删除(使用fc_safe_delete或启用 安全模式 通过fc_set_safe_mode通过回收站/废纸篓路由所有删除)- 无内置沙盒-安全性委托给MCP客户端层
- 仅通过stdio传输为本地使用而设计
______________________________________________________________________
发展
# Install dependencies
npm install
# Watch mode (auto-rebuild on changes)
npm run dev
# One-time build
npm run build
# Start the server
npm start看 贡献.md 关于贡献指南。
______________________________________________________________________
更新日志
看 更改日志.md 查看完整版本历史。
______________________________________________________________________
许可证
______________________________________________________________________
历史
该项目最初是作为 BACH文件管理员 (bach-filecommander-mcp).已重命名为 ellmos文件命令 (ellmos-filecommander-mcp)作为 埃尔莫斯 组织。
npm uninstall -g bach-filecommander-mcp
npm install -g ellmos-filecommander-mcp______________________________________________________________________
厄尔莫斯人工智能生态系统
此MCP服务器是 埃尔莫斯 生态系统——人工智能基础设施、MCP服务器和智能工具。
MCP服务器系列
| 服务器 | 工具 | 焦点 | npm |
|---|---|---|---|
| File指挥官 | 43 | 文件系统、流程管理、交互式会话 | ellmos-filecommander-mcp |
| CodeCommander | 17 | 代码分析、AST解析、导入管理 | ellmos-codecommander-mcp |
| 夹钳 | 12 | 文件修复、格式转换、批处理操作 | ellmos-clatcher-mcp |
| n8n管理器 | 13 | n8n通过AI助手进行工作流管理 | n8n-manager-mcp |
AI基础设施
| 项目 | 描述 |
|---|---|
| 巴赫 | 基于文本的LLMs操作系统——109+处理程序,373+工具,932+技能 |
| 离合器 | 提供中立的LLM编排,具有自动路由和预算跟踪功能 |
| 林萨尔 | 轻量级代理内存、连接器和自动化基础架构 |
| ellmos堆栈 | 自托管人工智能研究栈(Ollama+n8n+Rinnsal+知识文摘) |
| MarbleRun | Claude Code的自治代理链框架 |
| 园丁 | 极简主义数据库驱动的LLM操作系统原型(4个功能,1个表) |
| ellmos测试 | LLM操作系统测试框架(7个维度) |
桌面软件
我们的合作伙伴组织 空心砖 捆绑AI原生桌面应用程序——为AI时代构建的现代开源软件套件。类别包括文件管理、文档工具、开发人员实用程序等。
______________________________________________________________________
责任 / Liability
这个项目是一个 免费开源捐赠 根据BGB第516条。作者的责任根据 §521 BGB 在 故意和严重疏忽 有限。另外,GPL-3.0 / MIT / Apache-2.0 §§ 15-16(取决于所选择的许可证)中的免责声明也适用。
使用自担风险。不保证维护,不保证可用性,不保证无错误或适合特定用途。
该项目是一项无偿的开源捐赠。责任仅限于故意和重大过失(《德国民法典》第521条)。使用风险自负。无保修、无维护保证、不适用于任何目的。
