AX Local Operations MCP Server

文件操作：读取、写入、列出目录、创建目录、删除文件或目录。支持工作目录解析和相对路径。

示例：读取文件 { "operation": "read", "path": "src/index.js", "output_format": "json" } 示例：写入文件 { "operation": "write", "path": "test.txt", "content": "Hello", "output_format": "text" }

时间工具：获取当前时间，支持多种格式输出（ISO、UNIX、RFC3339、本地格式）。

示例：获取 ISO 格式 { "format": "iso", "output_format": "json" } 示例：获取指定时区 { "format": "locale", "time_zone": "Asia/Shanghai", "output_format": "text" }

文件行级编辑：在指定位置删除、插入、替换或追加内容。操作前自动备份原文件。

示例：删除第 3-5 行 { "operation": "delete_lines", "path": "test.js", "start_line": 3, "end_line": 5 } 示例：插入内容到第 2 行后 { "operation": "insert_lines", "path": "test.js", "start_line": 2, "content": "new line" }

文件内容搜索：在目录中搜索匹配正则表达式的内容。支持文件类型过滤、深度限制、超时控制和忽略模式。

示例：搜索 JS 文件中的函数定义 { "search_path": "src", "pattern": "function\s+\w+", "file_types": "js,ts" } 示例：忽略 node_modules 搜索 { "search_path": ".", "pattern": "TODO", "ignore": ["node_modules", "*.log"] }

文件差异比较：比较两个文件的差异，以文本或JSON格式输出差异统计和详细对比。

示例：比较两个文件 { "file1": "a.js", "file2": "b.js", "output_format": "json" }

文件哈希计算：使用MD5、SHA1、SHA256或SHA512算法计算文件哈希值，用于完整性验证。

示例：计算 SHA256 { "path": "package.json", "algorithm": "sha256", "output_format": "json" }

跨平台文件权限管理：Unix系统使用chmod，Windows系统使用icacls。支持递归设置。

示例：设置文件权限 { "path": "script.sh", "mode": "755" } 示例：递归设置目录权限 { "path": "project", "mode": "644", "recursive": true, "max_depth": 3 }

文件压缩/解压：支持ZIP、TAR、GZ、TAR.GZ格式。使用spawn安全参数，防止命令注入。

示例：压缩目录 { "operation": "compress", "source": "project", "destination": "backup.zip", "format": "zip" } 示例：解压文件 { "operation": "extract", "source": "archive.tar.gz", "destination": "./extracted" }

文件监控：监控文件或目录的创建、删除、修改事件。支持递归监控和深度限制。

示例：监控目录变化 { "path": "src", "events": "create,delete,modify", "duration": 60 } 示例：递归监控 { "path": "project", "events": "modify", "recursive": true, "max_depth": 3 }

命令执行：在系统中执行shell命令。支持管道、重定向，集成命令策略评估和sudo配置。

示例：列出文件 { "command": "ls -la", "output_format": "json" } 示例：带工作目录执行 { "command": "npm test", "working_directory": "/project", "timeout_ms": 120000 }

任务管理：创建、更新、完成、列出和清空任务。支持优先级、截止日期、子任务和进度跟踪。

示例：创建任务 { "operation": "create", "model_name": "claude", "title": "完成文档", "priority": "high" } 示例：更新进度 { "operation": "update", "model_name": "claude", "task_id": "xxx", "progress": 50 }

环境记忆：读取、更新和获取环境变量。环境变量存储在 ~/.local_file_operations/.env 文件中。

示例：读取全部 { "operation": "read", "output_format": "json" } 示例：设置变量 { "operation": "update", "key": "PROJECT_PATH", "value": "/project" }

Linux Sudo无密码配置管理：生成、安装、测试和管理sudoers配置。支持dry-run演练模式。

示例：检查sudo状态 { "action": "status" } 示例：生成配置 { "action": "generate", "username": "user", "scope": "limited", "dry_run": true }