Mmcp.market

zspace-cli MCP server

by skyzhao1223·io.github.skyzhao1223/zspace-cli·v0.1.4
No reviews yet

Zero-config MCP server + CLI for ZSpace NAS: manage files and pool stats via desktop client proxy.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

16 stars160 downloads/wk

Reviews

Write one

Nobody has reviewed zspace-cli yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

zspace-cli tools (14, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • zspace_check

    Check whether the ZSpace NAS is reachable through the local desktop client proxy and, if so, return a summary of storage pools.

  • zspace_copy

    Copy one or more files/directories on the NAS into a destination folder.

  • zspace_disk_stats

    Return raw disk statistics reported by the ZSpace NAS.

  • zspace_download

    Download a file from the ZSpace NAS to a local directory.

  • zspace_info

    Return detailed metadata for one file or directory on the ZSpace NAS.

  • zspace_ls

    List the contents of a directory on the ZSpace NAS at the given path.

  • zspace_mkdirwrite action

    Create a new directory on the ZSpace NAS under the given parent.

  • zspace_move

    Move one or more files/directories on the NAS into a destination folder.

  • zspace_pool_info

    List every storage pool on the ZSpace NAS with its name and capacity.

  • zspace_removewrite action

    Permanently delete one or more files/directories from the ZSpace NAS.

  • zspace_rename

    Rename one file or directory on the ZSpace NAS, keeping it in place.

  • zspace_search

    Search for files/directories on the NAS whose names contain the keyword.

  • zspace_tree

    Return a nested tree view of a directory on the ZSpace NAS.

  • zspace_uploadwrite action

    Upload a file from the local machine to a directory on the ZSpace NAS.

Public scan report

scanner v0.1.5 · 2026-09-19 · same rubric, same numbers if you re-run it

no findings
  • Code scan7 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 2 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

What the publisher says

From the zspace-cli repository's README, as published. We do not edit it. Read it on GitHub

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.

Beginner guide (no coding required) · Skills — incl. 8 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 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

zs check, zs ls, zs info, zs find, zs tree accept --json for machine-readable output. zs mv/zs cp/zs rm/zs down accept * ? glob patterns on the source path.

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).

Features

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Install directly

claude mcp add zspace-cli -- uvx zspace-cli
Add to Cursor

zspace-cli: common questions

Is zspace-cli MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the zspace-cli safety report
How do I install zspace-cli?
It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
Does zspace-cli need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is zspace-cli maintained?
The last commit was 3 days ago (2026-09-18). The latest release is v0.1.4.

More from skyzhao1223 →