本地操作工具集

AX本地操作 MCP 服务器

版本 2.8.0 · Node.js ≥ 18 · Windows / macOS / Linux

为大模型应用提供安全的本地操作能力：文件读写、行级编辑、搜索、比较、哈希、权限、压缩、监控、命令执行和任务管理。

快速开始

npx（推荐，无需安装）

{
  "mcpServers": {
    "ax_local_operations": {
      "command": "npx",
      "args": ["-y", "ax-local-operations-mcp"]
    }
  }
}

本地安装

npm install -g ax-local-operations-mcp

{
  "mcpServers": {
    "ax_local_operations": {
      "command": "ax-local-operations-mcp"
    }
  }
}

安装时会自动运行交互式向导设置默认工作目录。
也可在对话中临时指定：当前的工作目录是：/path/to/project

工具列表

¹ Windows 需要 zip/unzip/tar/gzip 在 PATH 中（Git Bash、WSL 或手动安装）。

安全策略

• 路径安全：securityValidator.resolveAndAssert() 阻止路径逃逸；拒绝路径中的隐藏目录组件（如 ../.hidden/file），但允许 .env 等点文件。
• 命令安全：仅拦截不可恢复的极危险命令（如 format C:、rm -rf /）；Agent 全控授权模式下无警告摩擦。
• 工作目录注入：index.js 会在每次工具调用前自动注入 working_directory，工具无需手动传入。

工作目录管理

# 对话中临时切换
当前的工作目录是：/path/to/project

# 通过工具持久化
workspace_manager: set /path/to/project
workspace_manager: get

开发

npm start                  # 启动 MCP 服务器
node test/runTests.js      # 运行完整测试套件（报告写入 test/reports/）
node test/integrationTest.js  # 注册表与平台集成测试
npm run release            # semantic-release（需 Conventional Commits）

添加新工具

1. 创建 tools/newTool.js，导出带 constructor(securityValidator) 和 async handle(args) 的类。
2. 在 tools/registry.js 中导入、实例化、添加描述符。
3. 详见 tools/tools_dev_guide.md。

平台兼容性

许可证

MIT