ellmos文件命令MCP服务器
🇩🇪 德语版
部分 埃尔莫斯 家庭。
全面的 模型上下文协议(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,并具有特定于平台的优化
安装
先决条件
- Node.js 18岁或以上
- npm
选项1:从NPM安装```bash
npm install -g ellmos-filecommander-mcp
### 选项2:从源代码安装```bash
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全局安装:```json
{
"mcpServers": {
"filecommander": {
"command": "ellmos-filecommander"
}
}
}
#### 如果从源代码安装:```json
{
"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传输为本地使用而设计
发展```bash
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包 `bach-filecommander-mcp` 已弃用。请使用 `ellmos-filecommander-mcp` 相反:```bash
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条)。使用风险自负。无保修、无维护保证、不适用于任何目的。
