Click on "Deploy 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., "@UGOS Pro MCP Server show me my NAS CPU, memory, and storage usage"
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.
把绿联 NAS（UGOS Pro 系统）的内部 API 封装成 MCP 工具，让 Loomy / Claude 等 AI Agent 用受控的方式操作 NAS——不走 SSH、不暴露高危能力、删除操作需二次确认。
灵感与 API 知识来源：极空间 NAS Skill 文章 + metaneutrons/ugos-cli 逆向文档（UGOS Pro 1.18.1 实测）。API 属于绿联官方未公开接口，随系统更新可能变动。
工具 | 功能 |
| 型号 / 序列号 / 系统版本 / CPU·内存·网卡硬件 |
| 实时 CPU / 内存 / 磁盘 / 网络 / 风扇 |
| 存储卷容量一览 |
| 目录浏览（分页） |
| 系统日志（关键词 / 级别 / 模块过滤） |
| 下载中心概况（应用未安装时自动降级提示） |
| 从 NAS 下载文件到本机 |
| 图库相册列表 |
| 图库 AI 物品分类 |
| 影视媒体库列表与扫描状态 |
| 影视库影片列表（片名/路径/海报/年份，支持分页与指定媒体库） |
| 影视合集列表（getCollectionList 正确端点，支持关键词过滤） |
| 影视中心首页媒体库信息 |
| 影视库搜索（电影/电视剧/合集） |
| 刮削源搜索：按片名搜豆瓣候选条目（手动识别第一步） |
| 查看合集内的影片列表 |
工具 | 功能 |
| 创建文件夹 |
| 重命名 |
| 上传本机文件到 NAS |
| 添加 HTTP / 磁力链下载任务 |
| 触发单部影片重新刮削（异步，豆瓣通道免 TMDB Key 实测有效） |
| 创建影视合集（multipart；库扫描中可能报 1300，稍后重试） |
| 把影片加入合集（category_id 从 nas_video_search 获取） |
confirm=true 才执行）工具 | 功能 |
| 删除文件 / 目录（ |
| 删除下载任务（可连同文件） |
Related MCP server: mcp-openmediavault
与 ugos-cli 文档基准（1.18.1）相比，1.19.1 有以下变化，本项目已适配：
变化 | 旧 | 新 |
文件管理 API 前缀 |
|
|
目录列表响应结构 |
|
|
照片库 API 版本 | —（未文档化） |
|
影视中心 API | —（未文档化） |
|
下载中心查询端点 |
| HTTP 404——应用可能未安装或已重构（已做降级处理） |
UGOS 每个应用是独立 Vue SPA，API 端点藏在其 JS bundle 中：
探测 SPA 入口：GET /photo/、/video/ 等返回 HTML，从中提取 assets/*.js
下载 bundle 后正则提取 getServerUrl("/ugreen/...") 与 v\d+/模块/动作 路径字符串
部分端点的必需参数需从调用处上下文提取（如 v1/video/all 的 page/pageSize/classification...）
照片：v5/photo/picture/timeline/list（时间线，POST，参数待确认）、picture/info、picture/exif、picture/download、picture/stream
人物：v5/photo/ai/figure/list（GET，参数待确认）、figure/cover
相册写操作：album/create、album/rename、album/item/add
影视：v2/video/mediaLibSet/poster-wall 已封装为 nas_video_list（关键参数：media_lib_set_id + classification=库ID + page_size 下划线风格）；v1/video/all 参数始终 1005，已放弃，由海报墙端点替代；v1/video/details/*（刮削/元数据）
下载中心：downloadCenter/download/add（添加任务路径未变，查询端点 404）
变量 | 必填 | 说明 |
| ✅ | NAS 局域网 IP，如 |
| ✅ | 登录账号 |
| ✅ | 登录密码 |
| — | HTTPS 端口，默认 |
| — | 设为 |
| — | 传输方式： |
| — | 远程模式监听地址，默认 |
| — | 远程模式监听端口，默认 |
NAS 侧无需安装任何组件——MCP 通过 UGOS Pro 自带的 HTTPS 端口（9443）通信。完整安装步骤见 INSTALL.md：
方案 A（推荐）：本机运行，接入 Loomy / Claude 等 PC 端 Agent；
方案 B（进阶）：NAS Docker 常驻（SSE 远程模式，UGOS_MCP_TRANSPORT=sse），供局域网内多客户端共享。
MCP 配置示例（local 类型）：
{
"ugos-nas": {
"type": "local",
"command": ["python", "/path/to/ugos-pro-mcp/server.py"],
"environment": {
"UGOS_HOST": "192.168.x.x",
"UGOS_USER": "你的账号",
"UGOS_PASSWORD": "你的密码",
"UGOS_ALLOW_WRITE": "1"
}
}
}$env:UGOS_HOST="192.168.x.x"; $env:UGOS_USER="admin"; $env:UGOS_PASSWORD="xxxx"
python -c "from ugos_client import UGOSClient; c=UGOSClient(__import__('os').environ['UGOS_HOST'], __import__('os').environ['UGOS_USER'], __import__('os').environ['UGOS_PASSWORD']); print(c.login()); print(c.system_info())"NAS 使用自签名 X.509 v1 证书，本客户端跳过证书校验（与 ugos-cli 0.8 行为一致）。 仅建议在可信局域网内使用；如需强化可参照 ugos-cli 0.9 的 TOFU 指纹锁定方案。
密码经 RSA PKCS1v1.5 加密后传输，不以明文出网。
所有错误信息已脱敏，不包含 token 与完整 URL。
UGOS 部分接口用 GET 传删除类参数，属系统设计；本 MCP 已在工具层加确认机制兜底。
UGOS Pro 版本差异可能导致字段变动（开发基准：1.19.1.0126）
照片 / 影视库刮削等模块（photo/、video/）已于 2026-10 封装，见工具清单
上传接口三要素（踩坑实录，缺一即静默失败或 1010）：
token 三处齐全：URL 参数 + X-Ugreen-Token（RSA 封装）+ X-Ugreen-Security-Key（MD5）
HTTP 头禁止非 ASCII：中文文件名需 RFC 5987 percent-encoding，ug-param JSON 需 ensure_ascii=True
ug-param 中 first_request 必须为 false（step2 是内容传输；为 true 服务端不落盘且返回 success 假象）
文件标签（tag_ids 字段存在但管理端点未挖到，常规命名均 9404）
手动触发全库扫描 media_lib/scan 疑似 SSE 流式接口，普通 HTTP 打不通
This server cannot be deployed
Self-hosted AI prompt library: prompts, collections, tags, teams, chains. 29 MCP tools for agents.
Deterministic AI agent microtools, no accounts/API keys. fetch_extract: 98% token cut. 38 tools.
Agent utility API: 28+ free endpoints (hash, QR, DNS, scrape, JWT...) run by an autonomous AI agent.
Independent directory of agentic AI tools — search, compare & recommend via MCP. Read-only.
