AX Local Operations MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AX Local Operations MCP Serversearch for 'TODO' in the /src directory and show the results"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
工具列表
工具名 | 说明 | 平台 |
| 文件读写、列出、创建目录、删除 | 全平台 |
| 行级编辑(插入、删除、替换、追加) | 全平台 |
| 正则/关键词内容搜索 | 全平台 |
| 文件差异对比 | 全平台 |
| MD5/SHA256 等哈希计算 | 全平台 |
| 权限读写(chmod / attrib / icacls) | 全平台 |
| 压缩/解压(zip/tar/gzip) | 全平台¹ |
| 文件/目录变更监控 | 全平台 |
| 执行系统命令(pwsh / bash) | 全平台 |
| 任务创建与跟踪 | 全平台 |
| 时间查询与格式化 | 全平台 |
| 持久化环境信息存储 | 全平台 |
| 工作目录管理 | 全平台 |
| 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)添加新工具
创建
tools/newTool.js,导出带constructor(securityValidator)和async handle(args)的类。在
tools/registry.js中导入、实例化、添加描述符。详见
tools/tools_dev_guide.md。
平台兼容性
平台 | 支持状态 |
Windows 10/11 | ✅ 完全支持(PowerShell 7 / pwsh) |
macOS | ✅ 完全支持 |
Linux | ✅ 完全支持(含 sudo_config) |
许可证
MIT
Maintenance
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