zspace-cli

Name: zspace-cli
Author: skyzhao1223

by skyzhao1223version 0.1.13i★ –iRuns on your computer

Registry nameio.github.skyzhao1223/zspace-cli

Install

Overview

Description from the maker (original English)

Zero-config MCP server + CLI for ZSpace NAS: file ops and pool stats via the desktop client.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
The registry lists no key to fill in.

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "zspace-cli": {
      "command": "uvx",
      "args": [
        "zspace-cli"
      ]
    }
  }
}

Run this in your terminal

claude mcp add zspace-cli -- uvx zspace-cli

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "zspace-cli": {
      "command": "uvx",
      "args": [
        "zspace-cli"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "zspace-cli": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zspace-cli"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account skyzhao1223, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 32620 servers in this category
Published to the registry more recently than 58% of the other 32620 servers in this category
Basic checks equal to or better than 100% of the other 32620 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is zspace-cli safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.13) reached the registry 29 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Intervals MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated 2 days ago

Install

Intervals MCP

by ljcl

Remote MCP server for intervals.icu run data and analysis

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

zspace-cli

English · 简体中文

Manage your 极空间 (ZSpace) NAS from the terminal or AI agents — no password, no SSH, no DDNS.

mcp-name: io.github.skyzhao1223/zspace-cli

Just keep the ZSpace desktop client logged in on macOS.

📖 How large-file sliced upload was born: 一次 1.4GB 备份引发的逆向 (zh, CSDN) · CLI guide: 极空间 NAS 命令行管理指南 (zh, CSDN)

Beginner guide (no coding required) · Skills — incl. 9 cross-NAS organizer skills for AI agents · 中文文档

Install

pip install zspace-cli        # base

pip install "zspace-cli[mcp]" # optional MCP support zs check # ✓ reads the desktop client login state

Prerequisite: the ZSpace desktop client is running and logged in on macOS.

Quick start

zs ls /sata11/my/data/影视

zs find "权力的游戏" # full-text search zs tree /sata11/my/data -d 3 zs up ./本地文件.mp4 /sata11/my/data/影视 # upload zs up ./本地文件.mp4 /sata11/my/data/影视 --verify # upload + MD5 round-trip check zs down /sata11/my/data/影视/某文件.mkv ./下载 # download

from zspace_cli import ZSpaceClient

with ZSpaceClient() as zs: for f in zs.ls("/sata11/my/data"): print(f"{'📁' if f.is_dir else '📄'} {f.name}")

CLI options

Command	Meaning
`zs check`	Verify the desktop client proxy is reachable
`zs ls [path]`	List directory (`-a/--hidden`, `-l/--long`)
`zs info`	Detailed file/dir info
`zs rename`	Rename a file or directory
`zs mv`	Move a file/directory
`zs cp`	Copy a file/directory
`zs mkdir`	Create a directory
`zs rm`	Delete into the personal recycle bin (`-f/--force` skips confirmation). Pool space is not freed until `zs recycle empty`
`zs find [path]`	Full-text search across the NAS
`zs tree [path]`	Tree view (`-d/--depth N`, default 2)
`zs usage`	Storage profile — physical usage per pool, per user, per category. The only view that includes Time Machine backups, other users' spaces, and Docker/RAID overhead (`--refresh`, `--wait N`)
`zs du ...`	Directory size via server-side statistics. Refuses to pass off a partial number as final when the NAS won't converge on a large tree; `--walk` forces an exact client-side traversal
`zs bigfiles [path]...`	Largest files, scanned server-side (`--min-size MiB`, `--top N`). Whole-library scan of 2.69M files took 2m41s versus 57 min for a client-side walk
`zs disks`	Per-disk free space, temperature, health, fragmentation, power-on hours, plus empty bays
`zs smart [sn]`	SMART report (`--all` for every disk)
`zs recycle list`	Recycle bin contents with original locations (`--public` for the shared bin)
`zs recycle restore`	Restore items to their original location
`zs recycle purge`	Permanently delete only the named items (`-f/--force`)
`zs recycle empty`	Purge the whole personal bin — irreversible, so it lists the contents first (`--public`, `-f`)
`zs recycle config`	Retention policy; `-1` means never auto-purge (`--my-cycle N`, `--public-cycle N`)
`zs up`	Upload (`-n/--name` to rename; `--verify` for post-upload MD5 round-trip verification; large files auto-switch to sliced upload)
`zs down [dir]`	Download
`zs baidu check/ls/tasks/fails/retry`	Baidu NetDisk via the NAS `/znetdisk/*` module (read side; `retry` mutates task state) — details
`zs skill`	Copy Agent skills into a project (`--list`, `--only a,b`)
`zs --config-dir`	Point at a non-default `vuex.json` location (or `ZS_CONFIG_DIR`)

zs check, zs ls, zs info, zs find, zs tree, zs usage, zs du, zs bigfiles, zs disks, zs smart, zs recycle list/config accept --json for machine-readable output. zs mv/zs cp/zs rm/zs down accept * ? glob patterns on the source path. zs baidu check/ls/tasks/fails also accept --json.

ls pages through large directories automatically (the NAS API returns at most 50 entries per call). find uses the NAS full-text index, so it searches across directories. Upload/download show a progress bar on a real terminal and stream the file (no full-file buffering). Pass --verify to zs up to download the uploaded file to a temporary directory and compare its MD5 with the local source; verification is opt-in because it doubles transfer. CJK paths work out of the box. Files above 64 MB are uploaded through the desktop client's sliced /v2/file/upload protocol (2 MB slices), because the local proxy rejects oversized single-request bodies with HTTP 413; a 413 on a smaller file falls back to slices automatically.

Features

Operation	CLI	SDK	MCP
List directory	`zs ls [path]`	`client.ls(path)`	`zspace_ls`
File info	`zs info`	`client.info(path)`	`zspace_info`
Rename	`zs rename`	`client.rename(path, name)`	`zspace_rename`
Create dir	`zs mkdir`	`client.mkdir(parent, name)`	`zspace_mkdir`
Move	`zs mv`	`client.move(src, dest)`	`zspace_move`
Copy	`zs cp`	`client.copy(src, dest)`	`zspace_copy`
Delete	`zs rm`	`client.remove(path)`	`zspace_remove`
Search	`zs find`	`client.search(kw)`	`zspace_search`
Tree view	`zs tree [path]`	`client.tree(path)`	`zspace_tree`
Upload	`zs up`	`client.upload(local, dir, verify=False)`	`zspace_upload`
Download	`zs down [dir]`	`client.download(path, dir)`	`zspace_download`
Health check	`zs check`	`client.is_connected()`	`zspace_check`
Storage pools	`zs check`	`client.pool_info()`	`zspace_pool_info`
Disk diagnostics	—	`client.disk_stats()`	`zspace_disk_stats`
Storage profile	`zs usage`	`client.usage_summary()`	`zspace_usage`
Directory size	`zs du`	`client.statistic(path)` / `client.walk_stat(path)`	`zspace_du`
Largest files	`zs bigfiles [path]`	`client.find_large(paths)`	`zspace_bigfiles`
Per-disk health	`zs disks`	`client.disks()` / `client.free_bays()`	`zspace_disks`
SMART report	`zs smart [sn]`	`client.smart(sn)`	`zspace_smart`
Recycle bin (read)	`zs recycle list/config`	`client.recycle_list()` / `client.recycle_config()`	`zspace_recycle_list` / `zspace_recycle_config`
Recycle bin (write)	`zs recycle restore/purge/empty`	`client.recycle_restore()` / `recycle_purge()` / `recycle_empty()`	`zspace_recycle_restore` / `zspace_recycle_purge` / `zspace_recycle_empty` (confirm-gated)
Baidu NetDisk (read side)	`zs baidu check/ls/tasks/fails/retry`	`client.baidu_*()`	—

Use with AI agents (Skills)

zs skill --list                           # see what's available

zs skill ~/your-project/.cursor/skills/ # install all (Cursor)

zs skill ~/your-project/skills/ # Claude Code, etc.

zs skill ~/your-project/skills/ --only nas-report,photo-organizer # or pick a few

Then tell your agent things like "list the files in /sata11/my/data". The skills ship inside the wheel, so zs skill works on any machine that has zspace-cli installed.

Besides zspace-nas (the zero-config base for ZSpace file ops), zs skill installs a family of 9 cross-NAS organizer skills. Their scanners are pure-stdlib and run on any mounted path (SMB/NFS), so they work with ZSpace, Synology, QNAP, UGREEN, etc. All follow the same read-only pattern: scan → the LLM drafts an old→new plan → you confirm → the agent executes (deletes always quarantine first).

Skill	What it does
nas-report	🧭 Entry point: whole-disk storage profile + routes you to the right specialist skill
file-sorter	🧹 Any mixed pile: recognizes 255 extensions across 15 categories (photos / video / audio / docs / ebooks / archives / installers / fonts / code / design sources / CAD drawings / disk images…), computes each `old → new` path, and knows 135 folder-name aliases (simplified + traditional Chinese + English) so an already-sorted library is never re-sorted. Never breaks up project folders by default
photo-organizer	Photos/videos: file by shoot date (`--exif` reads the real capture date via exiftool, or mdls on macOS), screenshots/WeChat images, burst de-dup
music-organizer	Music: Artist/Album/Track structure, track numbers, covers, built-in ID3v2 parsing
work-organizer	Work files: archive loose files, version chaos, copies, stale-file archiving
portfolio-organizer	Portfolio: project structure, cover/README, separate finals from sources
download-cleaner	Downloads: triage & clean (partials/torrents/installers/archives/unsorted media)
dedup-finder	Content-level exact de-dup (3-stage fingerprint size→head→full sha1, zero false positives)
backup-auditor	Backup health: version rotation, staleness, coverage check

Start with nas-report to see the big picture, then run whichever specialist it recommends. The most common combo is `dedup-finder` + `file-sorter`. De-duping first is *recommended* — you skip moving bytes you're about to delete, and you avoid same-name collisions — but the reverse order misses nothing: de-dup is content-level and independent of directory layout (verified: both orders find the identical duplicate groups). file-sorter reports suspected copies: X MB (N% of the bytes to move) so you can decide by the number instead of by a rule. See skills/README.md for the full list. Media-library naming stays a separate project: media-manager-skill.

How it works

ZSpace has no official CLI or public API. zspace-cli talks to the desktop client's local proxy, so it works behind NAT as long as the client is online:

Skill / zs / SDK / MCP  →  127.0.0.1:13579 (desktop client proxy)  →  NAS

Disclaimer — This is an unofficial, community-maintained project, not affiliated with or endorsed by ZSpace (极空间). It relies on the desktop client's local proxy interface, which is not officially documented. It only reads the login state of your own account on your own machine — it does not bypass authentication, crack encryption, or touch anyone else's data. Use at your own risk; make sure your use complies with the ZSpace user agreement and your local laws.

Platform support

Works on any OS where the ZSpace desktop client expose

Only the beginning is shown; read the rest in the repo

zspace-cli

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Intervals MCP

README from the maker

zspace-cli

Install

Quick start

CLI options

Features

Use with AI agents (Skills)

zs skill ~/your-project/skills/ # Claude Code, etc.

How it works

Platform support