Skip to content
Agentmart
Submit a tool

Ugnas MCP

Generic MCP server for UGREEN NAS (UGOS) over SSH — 39 tools with dry-run safety.

Connector by Omodaka9375 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 1
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/omodaka9375-ugnas-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Generic MCP server for UGREEN NAS (UGOS) over SSH — 39 tools with dry-run safety.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools
13 read · 17 write · 4 delete · 5 not yet classified
Secrets
3 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 39

Read from the source code; the running server may list different tools.

Read 13 · Look things up without changing anything.

  • docker.containers.inspect
  • docker.containers.list
  • docker.containers.logs
  • docker.images.list
  • docker.networks.inspect
  • docker.networks.list
  • files.find
  • files.list
  • network.interfaces
  • network.ports
  • network.routes
  • system.info
Show 1 more tools
  • system.status

Write 17 · Create, change, send or run things.

  • backup.create
  • backup.list
  • backup.restore
  • backup.schedule
  • backup.verify
  • docker.compose
  • docker.containers.restart
  • docker.containers.start
  • docker.containers.stop
  • docker.networks.connect
  • docker.networks.create
  • docker.networks.disconnect
Show 5 more tools
  • files.download
  • files.mkdir
  • files.move
  • files.sync
  • files.upload

Delete 4 · Delete, drop, revoke or wipe things.

  • docker.containers.remove
  • docker.images.remove
  • docker.networks.remove
  • files.remove

Not yet classified 5 · We could not tell from the name and description.

  • docker.images.pull
  • files.copy
  • files.thumbnail
  • files.usage
  • system.pools

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • UGNAS_HOST_KEY_SHA256
  • UGNAS_KEY_PATH
  • UGNAS_PASSWORD

Other settings (environment variables or headers).

  • UGNAS_DEFAULT_SHARE
  • UGNAS_HOST
  • UGNAS_MCP_CONFIG
  • UGNAS_PORT
  • UGNAS_USER

Network hosts it talks to 2

  • github.com · found in code
  • glama.ai · found in code

Files it touches

  • ~/.ssh/id_ed25519
  • /dev
  • Your home directory (~)
  • Any path the agent passes to its tools

Tools (39)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • backup.create

    Archive a directory into a .tar.gz on the NAS. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • backup.list

    List backup archives (*.tar.gz, *.tgz, *.tar, *.zip) in a directory. Read-only.

  • backup.restore

    Extract a .tar.gz archive into a destination directory. Destructive: returns a dry-run plan unless a confirmation token is supplied.

  • backup.schedule

    Install a cron job that runs recurring backups. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • backup.verify

    Check a backup archive exists, compute its checksum, and list its entry count. Read-only.

  • docker.compose

    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.

  • docker.containers.inspect

    Return full `docker inspect` JSON for one container. Read-only.

  • docker.containers.list

    List Docker containers on the NAS with id, name, image, state and status. Read-only.

  • docker.containers.logs

    Fetch the most recent log lines from a container. Read-only.

  • docker.containers.remove

    Delete a container. Destructive: returns a dry-run plan unless a confirmation token is supplied.

  • docker.containers.restart

    Restart a container. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • docker.containers.start

    Start a stopped container. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • docker.containers.stop

    Stop a running container. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • docker.images.list

    List locally stored Docker images. Read-only.

  • docker.images.pull

    Pull an image from its registry. Mutating: returns a dry-run plan unless a confirmation token is supplied.

Show 24 more tools
  • docker.images.remove

    Remove a local image. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • docker.networks.connect

    Attach a container to a network. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • docker.networks.create

    Create a Docker network. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • docker.networks.disconnect

    Detach a container from a network. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • docker.networks.inspect

    Return `docker network inspect` JSON (subnets, attached containers). Read-only.

  • docker.networks.list

    List Docker networks. Read-only.

  • docker.networks.remove

    Remove a Docker network. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • files.copy

    Copy a file or directory within the NAS (or NAS-to-NAS). Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • files.download

    Download a file from the NAS to the local machine via SFTP. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • files.find

    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.

  • files.list

    List a directory on the NAS (name, type, size, owner, modified). Read-only.

  • files.mkdir

    Create a directory. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • files.move

    Move or rename a path on the NAS. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • files.remove

    Delete a file or directory. Destructive: returns a dry-run plan unless a confirmation token is supplied.

  • files.sync

    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 token is supplied.

  • files.thumbnail

    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.

  • files.upload

    Upload a local file to the NAS via SFTP. Mutating: returns a dry-run plan unless a confirmation token is supplied.

  • files.usage

    Report disk usage (`du`) for a path, optionally per subdirectory. Read-only.

  • network.interfaces

    List host network interfaces with IPv4/IPv6 addresses and scopes. Read-only.

  • network.ports

    Show listening TCP/UDP sockets and the processes bound to them. Read-only.

  • network.routes

    Show the host IPv4 and IPv6 routing tables. Read-only.

  • system.info

    Report system details: OS release, CPU cores, load average, memory, temperatures, mounted disks, and Docker version. Read-only.

  • system.pools

    Report storage pool and RAID health: mdadm arrays and degradation state, LVM volume/logical/physical volumes, btrfs devices, block devices and filesystems. Read-only.

  • system.status

    Test connectivity to the configured UGREEN NAS over SSH and report hostname, kernel, uptime, and whether Docker is available. Read-only.

Signals

Stars
1
Forks
0
Open issues
0
Last commit
Oct 19, 2026 (9 days ago)
Last release
Oct 17, 2026 (11 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.Omodaka9375/ugnas-mcp
Version
0.1.2
Auth
API key
Packages
npm ugnas-mcp
License
MIT
Repository
github.com/Omodaka9375/ugnas-mcp
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from Omodaka9375

Cite this page

Ugnas MCP. Agent Mart. https://agentmart.dev/connectors/omodaka9375-ugnas-mcp (last updated 2026-10-24)