Server providing Argo CD integration for MCP clients.
Ugnas is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Generic MCP server for UGREEN NAS (UGOS) over SSH — 39 tools with dry-run safety.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user ugnas-mcp '--' npx -y ugnas-mcp
# 2 — ask your agent for something these tools do
# system.status, system.info, system.pools and 36 more
Ugnas costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts Ugnas as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.
This is a public server: you run it yourself and this marketplace is not in the path. You need Node.js — the current LTS (24) is the safe choice; npx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user ugnas-mcp '--' npx -y ugnas-mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Nothing is required, but it can take UGNAS_MCP_CONFIG (Path to the config JSON (default: ~/.ugnas-mcp/config.json). See the README for the schema.), UGNAS_HOST (NAS host, e.g. 192.168.1.50. Overrides the config file.), UGNAS_USER (SSH username. Overrides the config file.), UGNAS_KEY_PATH (Path to the SSH private key (alternative to UGNAS_PASSWORD).), UGNAS_PASSWORD (SSH password (alternative to UGNAS_KEY_PATH).), UGNAS_PORT (SSH port. Overrides the config file.), UGNAS_DEFAULT_SHARE (Base directory for relative tool paths (default /volume1).), UGNAS_HOST_KEY_SHA256 (Pinned SSH host key fingerprint (SHA256:...).) if you want to set them.
One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
39 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Test connectivity to the configured UGREEN NAS over SSH and report hostname, kernel, uptime, and whether Docker is available. Read-only.
No parameter schema on file.
Report system details: OS release, CPU cores, load average, memory, temperatures, mounted disks, and Docker version. Read-only.
No parameter schema on file.
Report storage pool and RAID health: mdadm arrays and degradation state, LVM volume/logical/physical volumes, btrfs devices, block devices and filesystems. Read-only.
No parameter schema on file.
List Docker containers on the NAS with id, name, image, state and status. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| all | boolean | no | Include stopped containers (default true). |
Return full docker inspect JSON for one container. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| container | string | yes | Container name or id. |
Fetch the most recent log lines from a container. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| container | string | yes | Container name or id. |
| tail | integer | no | Number of lines (default 200). |
Start a stopped container. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| container | string | yes | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Stop a running container. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| container | string | yes | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Restart a container. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| container | string | yes | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Delete a container. Destructive: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| container | string | yes | — |
| force | boolean | no | Force removal of a running container. |
| volumes | boolean | no | Also remove anonymous volumes. |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
List locally stored Docker images. Read-only.
No parameter schema on file.
Pull an image from its registry. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| image | string | yes | Image reference, e.g. nginx:latest. |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Remove a local image. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| image | string | yes | — |
| force | boolean | no | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
List Docker networks. Read-only.
No parameter schema on file.
Return docker network inspect JSON (subnets, attached containers). Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| network | string | yes | — |
Create a Docker network. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | — |
| driver | string | no | e.g. bridge, macvlan, overlay. |
| subnet | string | no | CIDR, e.g. 10.0.0.0/24. |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Remove a Docker network. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| network | string | yes | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Attach a container to a network. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| network | string | yes | — |
| container | string | yes | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Detach a container from a network. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| network | string | yes | — |
| container | string | yes | — |
| force | boolean | no | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Run docker compose up -d / down / restart for a stack directory on the NAS. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| directory | string | yes | Directory containing the compose file (relative paths resolve against defaultShare). |
| action | string | yes | — |
| file | string | no | Optional compose file name. |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
List a directory on the NAS (name, type, size, owner, modified). Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| directory | string | yes | Absolute path, or relative to defaultShare. |
Report disk usage (du) for a path, optionally per subdirectory. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | — |
| depth | integer | no | Per-directory depth (omit for total size only). |
Search for files by name glob and/or extension across a directory tree. Read-only. Returns path, size, modified time, and extension for each match.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | Directory to search (absolute, or relative to defaultShare). |
| name | string | no | Filename glob, e.g. '*.mp4' or 'IMG_2024*'. |
| extensions | array | no | Only these extensions, e.g. ['mp4','mkv'] (case-insensitive; leading dot optional). |
| type | string | no | Match files (default) or directories. |
| maxDepth | integer | no | Limit recursion depth. |
| limit | integer | no | Max results (default 100). |
Generate a preview thumbnail of an image or video on the NAS with ffmpeg and download it locally. For videos a frame is captured (default 1s in). Mutating (it writes a file on the local machine): returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | Image or video file on the NAS. |
| localPath | string | yes | Where to save the thumbnail on the machine running this MCP server. |
| width | integer | no | Thumbnail width in px (default 640; height auto). |
| time | string | no | Video frame timestamp, e.g. '00:00:05' (default 00:00:01). |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Create a directory. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Copy a file or directory within the NAS (or NAS-to-NAS). Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| source | string | yes | — |
| destination | string | yes | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Move or rename a path on the NAS. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| source | string | yes | — |
| destination | string | yes | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Delete a file or directory. Destructive: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | — |
| recursive | boolean | no | Delete directories recursively (default true). |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Upload a local file to the NAS via SFTP. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| localPath | string | yes | Path on the machine running this MCP server. |
| remotePath | string | yes | Destination on the NAS. |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Download a file from the NAS to the local machine via SFTP. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| remotePath | string | yes | File on the NAS. |
| localPath | string | yes | Destination on the machine running this MCP server. |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Sync a path to another on the NAS (or NAS-to-NAS) with rsync. A trailing slash on the source means 'contents', otherwise 'the directory'. If rsync is missing on the NAS, pass fallback:'cp' to use a built-in copy fallback (no delete/mirror). Mutating: returns a dry-run plan unless a confirmation…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| source | string | yes | Source path (trailing slash copies contents only). |
| destination | string | yes | Destination path (trailing slash = contents). |
| delete | boolean | no | Mirror the source, deleting extra files at the destination. |
| dryRun | boolean | no | Add rsync --dry-run to preview changes without writing. |
| extraArgs | array | no | Additional rsync flags, e.g. ['--exclude','*.tmp']. |
| fallback | string | no | What to do when rsync is missing on the NAS: 'refuse' (default) or 'cp' to use the built-in cp -a copy fallback. |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Archive a directory into a .tar.gz on the NAS. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | Directory to back up. |
| destinationDir | string | yes | Directory to write the archive into. |
| name | string | no | Archive file name (default: timestamped). |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
List backup archives (*.tar.gz, *.tgz, *.tar, *.zip) in a directory. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| directory | string | yes | — |
Check a backup archive exists, compute its checksum, and list its entry count. Read-only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| archive | string | yes | — |
Extract a .tar.gz archive into a destination directory. Destructive: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| archive | string | yes | — |
| destination | string | yes | — |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
Install a cron job that runs recurring backups. Mutating: returns a dry-run plan unless a confirmation token is supplied.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | Directory to back up. |
| destinationDir | string | yes | Directory to write archives into. |
| cron | string | yes | Cron expression, e.g. '0 3 * * *' for 03:00 daily. |
| name | string | no | Job label (default 'backup'). |
| confirmToken | string | no | Confirmation token echoed from a prior dry-run of THIS tool. Omit it to receive a dry-run plan. |
List host network interfaces with IPv4/IPv6 addresses and scopes. Read-only.
No parameter schema on file.
Show the host IPv4 and IPv6 routing tables. Read-only.
No parameter schema on file.
Show listening TCP/UDP sockets and the processes bound to them. Read-only.
No parameter schema on file.
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under MIT
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Ugnas or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | minimal | capability blast radius (minimal) — client exposure if the model is manipulated | −0 |
| verification-discount | repo | publisher verification (public source) — no provenance, but the source is public and inspectable | −1 |
| coverage-honesty | source | inspection depth (source) — how much of the target the scan could see | −0 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
Tools were statically extracted from the published source (39 recovered), not enumerated from a running server. Tool-poisoning, Unicode-smuggling, capability and toxic-flow analysis ran on this inferred surface, but a mis-parsed registration could be missed or mis-attributed, so tool-derived findings are capped below “confirmed”. To grade the real runtime surface, scan the running server: --command "npx -y <package>".
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. minimal is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| system.status | no tags | |
| system.info | no tags | |
| system.pools | no tags | |
| docker.containers.list | no tags | |
| docker.containers.inspect | no tags | |
| docker.containers.logs | untrusted-input | untrusted-input: keyword "fetch" |
| docker.containers.start | no tags | |
| docker.containers.stop | no tags | |
| docker.containers.restart | no tags | |
| docker.containers.remove | no tags | |
| docker.images.list | no tags | |
| docker.images.pull | no tags | |
| docker.images.remove | no tags | |
| docker.networks.list | no tags | |
| docker.networks.inspect | no tags | |
| docker.networks.create | no tags | |
| docker.networks.remove | no tags | |
| docker.networks.connect | no tags | |
| docker.networks.disconnect | no tags | |
| docker.compose | no tags | |
| files.list | no tags | |
| files.usage | no tags | |
| files.find | no tags | |
| files.thumbnail | untrusted-input | untrusted-input: keyword "download" |
| files.mkdir | no tags | |
| files.copy | no tags | |
| files.move | no tags | |
| files.remove | no tags | |
| files.upload | no tags | |
| files.download | untrusted-input | untrusted-input: keyword "download" |
| files.sync | no tags | |
| backup.create | no tags | |
| backup.list | no tags | |
| backup.verify | no tags | |
| backup.restore | no tags | |
| backup.schedule | no tags | |
| network.interfaces | no tags | |
| network.routes | no tags | |
| network.ports | no tags |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
Always latest — the install command names no version, so it installs the newest release when it runs; the current release on file is 0.1.2. Pin a release below and the command asks for exactly that one.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Ugnas can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.