AI导哈

NAS控制器

一个用于通过本地agent-browser CLI自动化管理UGOS PRO NAS的Node/TypeScript MCP服务器。

  • by eduardokanema
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 eduardokanema/ugreen-nas-ugos-mcp-server

使用说明

nas控制器

Node/TypeScript MCP服务器，用于通过本地自动化单个UGOS PRO NAS目标 agent-browser CLI。

当前范围

  • 登录到一个已配置的NAS目标
  • 保持加密的浏览器会话状态
  • 将相同的MCP工具暴露在 stdio 以及可选的流式HTTP
  • 以只读模式浏览桌面和Docker UI
  • 列出Docker容器，检查详细信息，读取日志，更新/重启/强制关闭/删除容器，管理MCP支持的终端
  • 通过搜索和分页读取Docker应用程序系统日志
  • 查看映像驱动的容器设置，创建新的Docker容器，并通过有限、重新创建或复制流来编辑现有容器
  • 搜索Docker镜像，开始下载，列出本地镜像，删除本地镜像，并从NAS导入一个本地镜像 .tar 路径

必需的设置

export NAS_UGOS_TARGET=192.168.50.80:9999
export NAS_UGOS_USERNAME=admin
export NAS_UGOS_PASSWORD=secret
export NAS_SESSION_KEY=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

可选：

export NAS_SESSION_DIR=.sessions
export NAS_SESSION_NAME=nas-192-168-50-80-9999
export NAS_HTTP_HOST=127.0.0.1
export NAS_HTTP_PORT=4010

跑

npm install
npm run build
node dist/src/server.js --http-port 4010

没有 --http-port，服务器运行在 stdio 只有。

当前MCP工具

  • nas.login
  • nas.session_status
  • nas.explore.desktop
  • nas.explore.docker
  • nas.docker.containers.list
  • nas.docker.containers.get
  • nas.docker.containers.logs.get
  • nas.docker.system_logs.list
  • nas.docker.containers.create
  • nas.docker.containers.edit
  • nas.docker.containers.activate
  • nas.docker.containers.deactivate
  • nas.docker.containers.update_image
  • nas.docker.containers.restart
  • nas.docker.containers.force_close
  • nas.docker.containers.delete
  • nas.docker.images.search
  • nas.docker.images.download
  • nas.docker.images.local.list
  • nas.docker.images.local.delete
  • nas.docker.images.local.import
  • nas.docker.terminals.list
  • nas.docker.terminals.create
  • nas.docker.terminals.read
  • nas.docker.terminals.write
  • nas.docker.terminals.close

验证

npm test
npm run build

容器创建应被视为有效的不可变。UGOS在创建后仅支持有限的就地编辑，因此应通过复制原始设置或谨慎使用重新创建当前工作流来处理更广泛的更改。

相关 MCP