Zspace CLI MCP Server

Zero-config MCP server + CLI for ZSpace NAS: file ops and pool stats via the desktop client. It runs locally over stdio via the published package.

People who work with file manager, nas and zspace and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-23 · ★ 24 · #4 OF 45 MAINTAINED FILESYSTEM · VERIFIED 2026-09-30

MIT · Python servers · how we verify → /methodology

01 · Install Zspace CLI

before you install - you'll need

Set ZS_CONFIG_DIR, ZS_CONFIG_HOST_DIR, ZS_BASE_URL before connecting.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package zspace-cli - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.skyzhao1223 is GitHub-verified and matches the repo owner

03 · What Zspace CLI can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.1.8 · 2026-09-23

distinguish sibling tools in all 14 descriptions + fix search scoping claim · fail with a clear message when the mcp extra is missing · dedupe Windows vuex.json candidates by NTFS semantics · shorten server.json…

v0.1.7 · 2026-09-21

v0.1.5 · 2026-09-20

04 · Who maintains Zspace CLI

zspace-cli is maintained by skyzhao1223. It's the only MCP server we track from this author; the repo dates to Jun 2026.

05 · Facts

repository: github.com/skyzhao1223/zspace-cli
category: filesystem - ranked #4 of 45 actively-maintained filesystem servers as of 2026-09-30.
release cadence: 7 releases in the last 90 days (latest 2026-09-23)
registry: io.github.skyzhao1223/zspace-cli (active, first published 2026-09-18 · 2 versions)
packages: pypi:zspace-cli

06 · Zspace CLI FAQ

What is Zspace CLI?

Zero-config MCP server + CLI for ZSpace NAS: file ops and pool stats via the desktop client. It runs locally over stdio via the published package.

Is Zspace CLI still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-23 and it shipped 7 releases in the last 90 days. We re-verify nightly.

How do I install Zspace CLI?

Run `uvx zspace-cli`. The README documents 3 environment variables (ZS_CONFIG_DIR, ZS_CONFIG_HOST_DIR, ZS_BASE_URL) to set first. Set ZS_CONFIG_DIR, ZS_CONFIG_HOST_DIR, ZS_BASE_URL before connecting. You can also paste the ready-made client config above.

Does Zspace CLI run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Zspace CLI

Alternatives to Zspace CLI

Maintained filesystem servers if Zspace CLI isn't the fit.

More filesystem MCP servers · Finn Tannlege MCP · Sugra API · Factorial HR · Tilde · Silicon Friendly

More Python MCP servers · OeBB (Austrian Railways) · Slowave · Openinsurance Wiki · AlphaFold Sovereign MCP · Semantic Scholar MCP Server · see all