Skip to main content
Glama
AndersHsueh

AX Local Operations MCP Server

by AndersHsueh

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


工具列表

工具名

说明

平台

file_operation

文件读写、列出、创建目录、删除

全平台

file_edit

行级编辑(插入、删除、替换、追加)

全平台

file_search

正则/关键词内容搜索

全平台

file_compare

文件差异对比

全平台

file_hash

MD5/SHA256 等哈希计算

全平台

file_permissions

权限读写(chmod / attrib / icacls)

全平台

file_archive

压缩/解压(zip/tar/gzip)

全平台¹

file_watch

文件/目录变更监控

全平台

execute_command

执行系统命令(pwsh / bash)

全平台

task_manager

任务创建与跟踪

全平台

time_tool

时间查询与格式化

全平台

environment_memory

持久化环境信息存储

全平台

workspace_manager

工作目录管理

全平台

sudo_config

sudo 无密码配置助手

Linux 专用

¹ 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


平台兼容性

平台

支持状态

Windows 10/11

✅ 完全支持(PowerShell 7 / pwsh)

macOS

✅ 完全支持

Linux

✅ 完全支持(含 sudo_config)


许可证

MIT

Install Server
F
license - not found
A
quality
C
maintenance

Maintenance

Maintainers
<1hResponse time
Release cycle
Releases (12mo)

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AndersHsueh/Ax-LocalTools-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server