Skip to main content
Glama

Codex 绿联云连接器

在 Codex 中读写绿联 NAS 文件、上传和下载文件,以及管理容器、下载任务和应用。连接器通过 MCP 调用绿联官方 unc CLI,支持的操作由 CLI、NAS 固件和访问令牌权限共同决定,没有额外的只读开关。

这是社区项目。本项目不附带官方 CLI,也不保存或分发访问令牌。每位使用者都需要安装 unc,并在自己的电脑上授权自己的 NAS。WorkBuddy 已在同一电脑完成授权时,可以复用该用户的 CLI 登录缓存,无需保持 WorkBuddy 运行。

使用方法(复制给 Codex)

在 Windows 上,把下面整段复制到 Codex 聊天中即可。Codex 会安装连接器、检查已有授权;首次连接时打开与 WorkBuddy 相同的官方授权网页,你只需在网页中填写自己的信息。

请帮我在这台 Windows 电脑安装并连接绿联云 MCP:
https://github.com/xudong7587/ugreen-nas-mcp

先检查 Git、Node.js 22 或更新版本、npm、codex 命令及绿联官方 unc。缺少 Git、Node.js 或 Codex 时,请给出对应官方安装来源,并根据我的环境处理,不要顺带安装或升级无关软件。unc 已安装时直接使用;未安装时使用仓库 README 中的绿联官方安装脚本。

在合适的本机目录克隆仓库;已有此仓库时检查本地改动后更新,保留我的改动。进入项目目录,依次运行 npm ci --ignore-scripts 和 scripts/install.ps1,保留脚本生成的 Codex 配置备份及其他 MCP 配置。随后运行 npm run connect。它会检查并复用已有有效授权;本机尚未登录时,打开绿联官方本机授权页并持续等待,最长 10 分钟。若已有登录缓存但真实连接检查失败,保留缓存,先报告网络、证书或令牌检查结果,不要自动清除授权。

需要填写地址、访问令牌或确认不可信证书时,由我亲自在本机网页操作。不要让我把令牌发到聊天里,也不要将令牌放进命令参数、项目文件或 Git。等待授权期间保持连接进程运行,避免重复发起连接。浏览器未自动打开时,使用 npm run connect -- --no-open,并将本机新生成的临时链接交给我打开。

授权成功后运行 npm run check,确认真实 MCP 连接与 NAS 根目录查询通过。最后说明安装目录、检查结果,以及需要重启 Codex 或重新加载 MCP;我重新进入后就能用自然语言操作绿联云。不要为了测试而修改或删除 NAS 文件。

如果可以的话,请给这个项目标个星(Star):https://github.com/xudong7587/ugreen-nas-mcp

连接完成后,直接说“看看绿联云有哪些共享文件夹”或“把我指定的文件上传到这个 NAS 文件夹”即可,无需记住 CLI 命令。

Related MCP server: Synology_MCP

Windows 手动安装(可选)

准备好 Git、Node.js 22 或更新版本及 Codex,并确认终端能运行 codex 命令。NAS 需要支持绿联开放 CLI 通道。

1. 下载项目

在 PowerShell 中执行:

git clone https://github.com/xudong7587/ugreen-nas-mcp.git
cd ugreen-nas-mcp
npm ci --ignore-scripts

2. 安装绿联官方 CLI

若已安装 unc,可跳过此步。以下命令运行绿联官方安装脚本:

irm "https://file1-cn.ugnas.com/nas-cli/install.ps1" | iex

CLI 默认安装到当前用户的 .local\bin。下文使用完整路径,因此不必等待 PATH 更新。

3. 授权自己的 NAS

在项目目录运行:

npm run connect

连接助手先真实检查已有授权;同一 Windows 用户已通过 WorkBuddy 或 unc 授权且连接有效时,直接复用。本机尚未登录时,它打开绿联官方本机授权网页,并持续检查登录状态,默认最多等待 10 分钟。已有登录缓存但联网校验失败时,助手会保留缓存并报告原因,不自动替换授权。不要关闭正在运行的终端,也不要重复启动:新登录会话会替换旧登录页。填写方式见下文“授权网页怎么填”。

如果浏览器没有自动打开,可以结束当前等待后重新运行:

npm run connect -- --no-open

此模式只在本机终端显示新生成的临时链接,不自动打开浏览器;复制到这台电脑的浏览器打开,并保持终端运行。若使用 Codex,直接让它“帮我连接绿联云,打开授权页”即可。

也可以不用网页,选择官方 CLI 的交互式终端登录:

& "$env:USERPROFILE\.local\bin\unc.exe" auth login

按提示在本机填写 NAS 地址与令牌,不需要填写账号。此终端方案接受带端口的局域网 HTTPS 地址或完整 UGLink 地址;网页的 UGREENlink ID 输入框则填写纯 ID。已有 WorkBuddy 授权时,也可单独检查连接:

& "$env:USERPROFILE\.local\bin\unc.exe" auth status --check --format json

成功应返回 authenticated: true 且 opencli.connected: true。--check 会真实联网校验;未加此参数时只检查本地缓存。

连接成功不代表令牌拥有每个业务方法的权限。写操作被 NAS 拒绝时,按错误中的方法名检查授权,必要时更换具有所需权限的令牌并重新登录。部分应用管理操作还需要管理员权限。

4. 注册到 Codex

在项目目录执行:

& .\scripts\install.ps1

脚本会备份原有 Codex 配置,保留其他 MCP 配置,并注册名为 ugreen-nas 的服务。若设置了 CODEX_HOME,脚本使用该目录中的配置。项目目录就是服务运行目录,安装后请保留;移动目录后重新运行安装脚本。

重启 Codex,在“设置 → MCP servers”中查看 ugreen-nas。也可以在聊天中输入 /mcp 查看连接状态。入口说明见 Codex MCP 文档。

在新聊天中直接说:

  • “看看绿联云有哪些共享文件夹。”

  • “在绿联云里搜索名字包含‘合同’的 PDF。”

  • “查看 NAS 的存储卷容量和容器状态。”

  • “把这个 NAS 文件下载到我指定的本机文件夹,然后帮我分析。”

  • “把我指定的本机文件上传到这个 NAS 文件夹,同名时自动改名。”

  • “在这个 NAS 文件夹里创建一个子目录,把我指定的文件移进去。”

  • “把这条链接交给 NAS 下载到我指定的目录。”

授权网页怎么填

这就是 WorkBuddy 点击绿联云图标时打开的官方页面,由本机 unc 提供。Codex 通过连接助手打开同一页面,不需要先安装或运行 WorkBuddy。

地址与访问令牌

字段旁的 ⓘ 是填写说明,不代表连接故障。鼠标移到图标上可以查看提示:

页面项目

网页提示与填写方法

UGREENlink ID

提示为“在「绿联云」App 的‘控制面板 > 设备连接 > 远程访问’中查看”。填写自己的纯 ID,例如 your-id,不要粘贴 https://ug.link/your-id;ID 只包含字母、数字和连字符。

DDNS 页签

地址标签为“DDNS(动态域名)”,提示“可填写DDNS域名或IP地址”。也用于局域网 IP。输入框已固定显示 https://,后面填写域名或 IP 及实际 HTTPS 端口,例如 192.168.1.10:9443;9443 只是示例,以自己 NAS 的设置为准。不要重复填写前缀,也不要填写 http://。

访问令牌

提示为“在「绿联云」App 的‘个人中心 > 本地账号 > 访问与授权’中创建”。在该入口创建访问令牌,按需要选择查询或读写权限,再粘贴到本机网页。使用开放平台令牌,通常以 ugpoa_v1. 开头,不是 NAS 登录密码。

令牌框右侧眼睛

切换显示或隐藏令牌,方便自己核对。不要把显示令牌的截图、令牌正文或认证缓存分享出去。

连接 按钮

地址与令牌都填写后才可点击;任一项为空时显示为灰色。提交过程中显示“连接中”。

令牌决定允许执行哪些方法,连接器没有额外的只读限制。需要写入时,应在创建令牌时授予对应读写权限;部分管理功能还要求管理员账号。需要扩大权限时,请在 NAS 上检查授权,必要时新建具有所需权限的令牌并重新授权。

证书提示与连接结果

页面顶部说明“所有连接均使用HTTPS加密,遇到不可信证书时,将由你确认后再继续”。出现“不可信证书”弹框时,会提供“取消”和“仍要继续”:请你亲自核对目标地址,确认这是自己的 NAS 后再决定是否继续。Codex 不会代替你点击接受。

成功页显示“授权已完成”,下面仍写着“请返回 WorkBuddy,等待连接结果”。这是官方页面的固定文案;使用本项目时返回 Codex 即可,连接助手会继续检查授权结果。随后运行 npm run check,确认连接和根目录查询通过,再重启 Codex 或重新加载 MCP。

若显示带 ! 的“本次授权已失效”,或临时地址已无法打开,请重新运行 npm run connect 获取新页面。不要刷新、收藏或继续使用旧链接;重新启动会替换旧会话。

临时链接与等待时间

授权页地址形如 http://127.0.0.1:<随机端口>/login/<随机串>/#/。127.0.0.1 只指向当前电脑;端口和路径每次生成,不能作为固定入口,也不能分享给其他人使用。其他使用者在自己的电脑运行连接助手,为自己的 NAS 授权。

这里的 http://127.0.0.1 是本机授权网页地址,填写的 NAS 地址仍使用 HTTPS;两者用途不同。令牌只在自己的本机页面输入,不需要发送到 Codex 聊天或公开仓库。

本项目的 npm run connect 默认等待 10 分钟并持续检查状态。直接调用官方 unc auth workbuddy 时,CLI 默认等待 5 分钟,且需要调用方持续检查登录状态;日常连接优先使用本项目助手,等待时保持运行终端打开。

常见提示

提示或现象

处理方式

请输入 UGREENlink ID / 请输入 DDNS 地址 / 请输入访问令牌

补齐对应字段。令牌只在本机网页填写。

UGREENlink ID…格式不正确,只能包含字母、数字和连字符

填纯 ID,不要填写整条 UGLink 网页地址。

ug.link 是跳转域名,请改用「UGREENlink ID」方式并填写你的 ID

切换到 UGREENlink ID 页签并填写自己的 ID。

IP 地址必须带端口 / IPv6 地址必须带端口 / 主机名必须带端口

填入 NAS 实际 HTTPS 端口,例如 192.168.1.10:9443。IPv6 按页面给出的示例填写。

连接必须使用 HTTPS,请去掉地址里的 http://

去掉输入内容中的 http://,使用输入框自带的 https://,并核对 HTTPS 端口。

未找到 UGREENlink ID…

在绿联云 App 的远程访问设置中核对 ID。

查询 UGREENlink ID…失败 / 无法连接到…

检查 NAS 是否开机、地址与端口是否正确,以及当前网络和代理是否可达。

访问令牌无效,请检查后重试

检查是否粘贴完整、是否已过期或停用;必要时新建令牌后在网页重新授权。

该 NAS 暂不支持连接器,请升级 NAS 系统或检查地址

检查 NAS 系统对开放 CLI 通道的支持及连接地址;不要反复换令牌。

确认已过期,请重新填写并连接

证书确认已过期,重新填写并连接;若会话也失效,重新运行连接助手。

凭证保存失败 / 连接失败…详细原因见日志

按提示检查本机连接日志;可使用 unc auth log --lines 50 查看,分享日志前移除私人信息。

已连接,但操作提示访问令牌未授权该方法

按错误中的方法名新建具有相应权限的令牌,再重新授权;连接成功不等于具备每项操作权限。

提供的工具

1.2.0 提供 18 个 MCP 工具,保留原有工具接口;网页授权由本机连接助手完成。

工具

用途

ugreen_connection_status

查看登录状态,默认真实联网检查

ugreen_list_files

列出个人/共享根目录或指定文件夹,支持分页

ugreen_file_stat

查询文件或目录元数据

ugreen_read_file

分段读取文本,每次最多 256 KiB;二进制或不完整 UTF-8 字节段返回 Base64

ugreen_search

按名称搜索,可限定目录和后缀

ugreen_search_results

根据搜索任务继续获取结果

ugreen_download_file

下载到用户指定的本机绝对路径,默认拒绝覆盖

ugreen_nas_info

查询存储、容器、镜像、Compose、已装应用和实时负载

ugreen_upload_file

从本机绝对路径上传到 NAS,支持冲突处理和校验

ugreen_create_directory

创建目录,可按需创建父目录和设置八进制权限

ugreen_create_file

创建文件并可写入初始文本,默认要求文件不存在

ugreen_write_file

覆盖、追加或按字节偏移写入文本

ugreen_copy_file

复制到指定 NAS 目录,支持冲突处理

ugreen_move_file

移动到指定 NAS 目录,或在同一目录中重命名

ugreen_delete_file

删除指定文件或目录,默认不递归、移入回收站

ugreen_restore_file

从回收站路径恢复文件

ugreen_cli_help

查看允许的业务命令帮助,无需认证

ugreen_execute

执行允许的官方 CLI 业务命令,覆盖文件、Docker、下载、应用和控制面板等功能

上传、复制和移动的 on_conflict 可选 rename、skip、replace;上传默认 rename。覆盖需要用户明确要求。创建目录默认权限为 0755,创建文件默认权限为 0644。创建文件的初始文本最多 16 KiB,写入文本每次最多 256 KiB,均按 UTF-8 字节计;patch 写入必须指定 offset。ugreen_write_file 只写入已存在的文件,新文件使用 ugreen_create_file 或上传。

专用文件写工具均支持 dry_run。通用工具 ugreen_execute 接收业务叶命令 command、字符串数组 arguments、可选文本 stdin,以及默认 false 的 dry_run。先用 ugreen_cli_help 确认当前 CLI 的具体参数;通用工具的 --yes 按命令要求放在 arguments 中,专用写工具自动处理 CLI 确认参数。

ugreen_execute 只开放已实现的业务命令,包含 file、docker、download、app、ctl、storage、network、taskmgr、search 和 doctor。它不执行 shell,也不开放令牌导出、切换认证、升级或卸载 CLI 等本机管理操作。当前官方 CLI 的存储、网络和任务管理器接口只提供查询;控制面板写操作包括创建用户、向自建群组追加成员。连接器不提供 CLI 尚未公开的功能,例如修改文件 ACL。

通用工具的命令和参数清单依据官方 unc 0.1.61,覆盖 99 个业务叶命令。CLI 将来新增的命令或参数,需要同步更新连接器清单。

写操作与结果核对

每次操作按用户给定的对象和范围执行。删除、覆盖、启停服务等重要操作先用 dry_run: true 核对影响;已有明确业务授权时可继续执行,超出范围再向用户确认。连接器开发和升级的授权,不包含修改或删除用户现有 NAS 文件来测试。

预演可能由 NAS 处理,也可能由 CLI 返回本地计划,以返回说明为准;预演不表示已经执行,也不保证真实操作成功。--yes 仅处理 CLI 确认,不提升令牌权限。写操作失败、超时或断线后应先查询当前状态,不自动重试,避免重复创建或修改。批量结果需逐项检查 success,异步任务应核实终态后再报告完成。

实测部分新文件创建预演会因目标尚不存在而返回 NotFound;这不能单独证明令牌只读,也不能证明真实创建一定失败。连接器保留原始错误,不把预演失败改成真实执行。

跨目录移动时,destination 必须是目标目录;同目录重命名时使用纯新文件名。永久删除需要显式设置 permanent: true 并有对应授权;递归删除需要显式设置 recursive: true。创建共享注册项后,CLI 没有注销接口,清理共享应在 NAS 管理界面完成,不能用删除文件代替。

目录列表和搜索可能有多页,需根据返回的分页字段继续查询;搜索使用 task_id 和 next_offset。容器查询最多返回一页 100 项,进程和服务查询返回按 CPU 排序的前 20 项。

先列出根目录,再使用结果中的路径。/volume1 等卷根路径不能代替共享文件夹路径。工具保留官方 CLI 的 JSON 结构,64 位数值可能以字符串返回。

不同固件、套件版本和令牌权限支持的功能不同。遇到权限或兼容性错误时,查看返回的 error_detail 与 compatibility_hint;部分方法在旧固件上不可用,重复登录不会补齐功能。

维护与移除

已安装的用户在原项目目录升级:

git pull --ff-only
npm ci --ignore-scripts
& .\scripts\install.ps1

然后重启 Codex,使其重新加载 18 个工具。现有 CLI 登录缓存可以继续使用;增加写工具不会自动扩大令牌权限。

运行测试:

npm test

自动化测试通过模拟 CLI 校验工具、参数和错误处理,不修改真实 NAS 文件。

检查真实 MCP 连接和 NAS 根目录查询:

npm run check

此检查需要已授权的 NAS,只打印检查状态和结果数量,不打印文件名或内容。

移除 Codex 中的注册:

& .\scripts\install.ps1 -Remove

这会保留项目文件和 CLI 登录缓存。本机显示未登录时,运行 npm run connect 打开授权页;已有缓存但校验失败时,先排查提示原因。需要明确更换授权时,可选择终端中的 unc auth login --force,或在 WorkBuddy 的绿联云连接器中重新连接。两端共用同一用户的 CLI 缓存,登出会同时影响两端。

项目默认使用用户目录下的 .local/bin/unc.exe(Windows)或 .local/bin/unc。自定义安装位置可给 MCP 进程设置 UGREEN_UNC_BIN,值必须是绝对路径。服务使用 CLI 缓存认证,不使用继承环境中的 UNC_NAS_TOKEN、UNC_NAS_URL 或 UNC_NAS_INSECURE。

连接方式的调查记录见 investigation.md。请勿将 .unc 认证缓存、Codex 配置备份或 NAS 私人数据提交到公开仓库。

本适配器按 MIT 许可证发布;绿联官方 CLI 需单独获取,适用其自身的使用条款。

Available Tools

18 tools
ugreen_cli_helpA
Read-onlyIdempotent

离线查看官方 unc 业务命令组或子命令帮助,确认当前 CLI 的参数。不会访问 NAS,也不读取登录缓存。command 使用空格分隔的命令路径。

Inputs: command (required).

ugreen_connection_statusB
Read-onlyIdempotent

检查绿联云登录和 NAS 连通性。默认实际联网;不会读取或返回令牌。

Inputs: check.

ugreen_copy_fileA
Destructive

复制一个 NAS 文件或目录到已存在的目标目录,保留原名。destination_directory 必须是目录,不能写“目录/新文件名”;需要改名时另行移动为纯文件名。默认同名自动改名,replace 会覆盖;先 dry_run 核对覆盖影响。仅操作用户指定的对象;写操作失败后先查询当前状态,不自动重试。权限由绿联令牌与 NAS 账户决定。

Inputs: source_path (required), destination_directory (required), dry_run, on_conflict.

ugreen_create_directoryA
Idempotent

在指定 NAS 路径创建普通目录。parents 仅在用户要求创建缺失父目录时使用;mode 是八进制权限。创建共享注册项应使用专门的共享工具。仅操作用户指定的对象;写操作失败后先查询当前状态,不自动重试。权限由绿联令牌与 NAS 账户决定。

Inputs: path (required), mode, dry_run, parents.

ugreen_create_fileA
DestructiveIdempotent

创建一个 NAS 文件,content 为 UTF-8 文本(可为空),最多 16 KiB;更大或二进制内容使用 ugreen_upload_file。默认 exclusive=true,已存在时失败;mode 是八进制权限。仅操作用户指定的对象;写操作失败后先查询当前状态,不自动重试。权限由绿联令牌与 NAS 账户决定。

Inputs: path (required), mode, content, dry_run, +1 more.

ugreen_delete_fileA
DestructiveIdempotent

删除用户指定的一个 NAS 文件或目录,默认移入回收站。recursive 默认为 false;删除目录及其内容必须明确指定 true。permanent 仅在用户明确要求永久删除时使用,永久删除不能恢复。先 dry_run 核对范围;CLI 会保护共享根目录并复核删除结果。回收站路径见 data.receipt.final_path,保存它以便恢复。仅操作用户指定的对象;写操作失败后先查询当前状态,不自动重试。权限由绿联令牌与 NAS 账户决定。

Inputs: path (required), dry_run, permanent, recursive.

ugreen_download_fileA

把一个 NAS 文件下载到用户指定的本机绝对路径。默认拒绝覆盖已有文件。下载内容可用 Codex 的本地文件工具继续处理。

Inputs: local_path (required), remote_path (required).

ugreen_executeA
Destructive

执行官方 unc 的完整 NAS 业务命令,权限由现有令牌和 NAS 固件决定。command 选择叶命令路径,arguments 是独立参数数组,不要包含 unc、命令路径或 shell 语法。先查询帮助和目标对象,再按用户授权操作;删除、覆盖、服务变更等先 dry_run 预演。需要确认门禁时显式传 --yes,已有授权无需重复询问。dry_run 默认 false;预演可能联网,成功不保证真实执行成功。流式请求最多 1800 秒;写操作超时或失败后先查状态,不自动重试。stdin 为 UTF-8 内容,创建用户仅用 --password-stdin 与 stdin 传密码。认证覆盖、输出重定向、调试和 CLI 本机管理命令不可用。

Inputs: command (required), stdin, dry_run, arguments.

ugreen_file_statA
Read-onlyIdempotent

查询一个 NAS 文件/目录的元数据;使用列表或搜索返回的路径。结果在 items[0].data.stat,64 位数值可能是字符串。

Inputs: path (required).

ugreen_list_filesB
Read-onlyIdempotent

列个人/共享根目录或指定文件夹。默认列共享文件夹。使用一元 ls-root,兼容流式接口不可用的设备。文件数组在 data.data.file_list.files;保留 total/page 等官方字段。

Inputs: page, path, root, sort, +2 more.

ugreen_move_fileA
Destructive

移动或重命名一个 NAS 文件/目录。跨目录 destination 必须是已存在的目录绝对路径;同目录改名只能给不含斜杠的纯文件名。跨目录改名分成两步,不使用“目录/新文件名”。默认同名自动改名,replace 会覆盖;先 dry_run 核对。仅操作用户指定的对象;写操作失败后先查询当前状态,不自动重试。权限由绿联令牌与 NAS 账户决定。

Inputs: destination (required), source_path (required), dry_run, on_conflict.

ugreen_nas_infoA
Read-onlyIdempotent

查询存储卷/池/磁盘、容器/镜像/Compose、已装应用和任务管理器状态。不会启停服务或改 NAS 设置。容器最多一页 100 项,进程/服务返回 CPU 排序前 20 项;旧固件可能不支持部分命令。

Inputs: section (required).

ugreen_read_fileA
Read-onlyIdempotent

有界读取 NAS 文件,默认 UTF-8 文本,二进制用 base64。每次最多 256 KiB;继续读取使用 offset。仅在用户请求相应文件时使用。

Inputs: path (required), length, offset, encoding.

ugreen_restore_fileA

从回收站恢复一个 NAS 文件或目录,recycle_path 必须使用删除结果 data.receipt.final_path 或回收站列表返回的路径。dry_run 无法确认路径真的处于回收站,不能把预演当作已恢复。仅操作用户指定的对象;写操作失败后先查询当前状态,不自动重试。权限由绿联令牌与 NAS 账户决定。

Inputs: recycle_path (required), dry_run.

ugreen_search_resultsA
Read-onlyIdempotent

继续读取搜索结果。task_id 必须来自搜索返回值,排序保持 name/asc。

Inputs: task_id (required), limit, offset.

ugreen_upload_fileA
Destructive

把一个本地普通文件上传到指定 NAS 绝对路径。remote_path 以 / 结尾时沿用本地文件名;默认同名自动改名,replace 会覆盖。verify 核对 SHA-256;dry_run 仅预演,不上传内容。仅操作用户指定的对象;写操作失败后先查询当前状态,不自动重试。权限由绿联令牌与 NAS 账户决定。

Inputs: local_path (required), remote_path (required), verify, dry_run, +1 more.

ugreen_write_fileA
Destructive

写入一个已存在的 NAS 文件,UTF-8 内容最多 256 KiB。write 覆盖原内容;append 追加;patch 按字节 offset 局部写入。仅 patch 接受 offset;新建文件使用 ugreen_create_file 或上传。先用 dry_run 核对重要覆盖。仅操作用户指定的对象;写操作失败后先查询当前状态,不自动重试。权限由绿联令牌与 NAS 账户决定。

Inputs: path (required), content (required), mode, offset, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 18 tools

    Disambiguation4/5

    The file-operation tools are mostly clearly separated: list, search, stat, read, write, upload, download, copy, move, delete, and restore each have a distinct action and that action is stated in the description. The main overlaps are create_file versus write_file versus upload_file, and the generic ugreen_execute can duplicate any specific tool; however, the descriptions explicitly route ambiguous cases.

    Naming Consistency4/5

    All tools use a consistent ugreen_ prefix and snake_case, with mostly verb_noun names such as ugreen_list_files, ugreen_create_directory, and ugreen_delete_file. A few names are noun-first or non-verb, such as ugreen_file_stat, ugreen_nas_info, ugreen_search_results, and ugreen_execute, but the pattern remains readable and predictable.

    Tool Count4/5

    With 18 tools, the set is slightly heavier than the ideal range, but the file lifecycle genuinely requires many operations. Each tool has a clear role: the generic execute and help tools are infrastructure, while the rest cover concrete NAS file-management tasks.

    Completeness3/5

    Core file lifecycle coverage is strong: create, read, write, upload, download, copy, move, delete, restore, search, stat, and listing are all present. However, there are notable gaps: no dedicated recycle-bin listing tool even though restore depends on recycle paths, no share-management tool despite the create-directory description referencing one, and no permission/chmod operation beyond mode at creation. The generic execute tool can fill these gaps but does so as an escape hatch rather than as first-class coverage.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Synology NAS services including DSM, File Station, Calendar, Note Station, Contacts, Chat, Download Station, and Container Manager through a modular MCP interface with configurable safety modes.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP-compatible coding agents to execute the local Codex CLI as a coding agent, including code reviews, session resume/fork, and CLI diagnostics.
      9
      12 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables self-hosted access to Synology NAS files, system monitoring, container management, and download tasks through MCP clients, with optional connectivity to ChatGPT via a secure tunnel.
      3
      1
      MIT