zspace-cli — MCP-сервер для Claude Code: функции и установка
Даёт агенту доступ к файлам и сведениям о хранилище ZSpace NAS. Работает через запущенный клиент ZSpace на macOS.
claude mcp add zspace-cli -- uvx zspace-cliЧто делает zspace-cli
Через MCP-сервер агент может просматривать каталоги, искать файлы, загружать и скачивать их, а также переименовывать, перемещать и копировать. Есть инструменты для просмотра занятого места, состояния дисков и содержимого корзины. Те же операции доступны из командной строки zs.
Сервер использует авторизованный клиент ZSpace на macOS: он должен быть запущен и оставаться в системе. Без этого условия подключение к NAS не заработает. Для установки в Claude Code команда запускает пакет через uvx: claude mcp add zspace-cli -- uvx zspace-cli.
Какие задачи решает
- найти файл по названию на NAS
- загрузить локальный файл в каталог ZSpace
- скачать файл с NAS на компьютер
- проверить занятое место и состояние дисков
- восстановить файл из корзины
Примеры запросов агенту
- Найди на NAS файл с названием «договор» и покажи его путь.
- Загрузи
./отчёт.pdfв/sata11/my/data. - Проверь занятое место по пулам хранилища.
Как установить zspace-cli
Командой платформы
claude mcp add zspace-cli -- uvx zspace-cliuvx запускает команду с именем пакета; если в README она другая — uvx --from zspace-cli <команда>
Командой платформы
codex mcp add zspace-cli -- uvx zspace-cliuvx запускает команду с именем пакета; если в README она другая — uvx --from zspace-cli <команда>
Файл настроек
{
"mcpServers": {
"zspace-cli": {
"command": "uvx",
"args": [
"zspace-cli"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from zspace-cli <команда>
Файл настроек
{
"servers": {
"zspace-cli": {
"type": "stdio",
"command": "uvx",
"args": [
"zspace-cli"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from zspace-cli <команда>
Командой платформы
gemini mcp add zspace-cli uvx zspace-cliuvx запускает команду с именем пакета; если в README она другая — uvx --from zspace-cli <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о zspace-cli
Как установить zspace-cli в Claude Code?
Выполните claude mcp add zspace-cli -- uvx zspace-cli. Перед запуском убедитесь, что клиент ZSpace открыт и авторизован на macOS.
Что делает zspace-cli?
Позволяет агенту управлять файлами на ZSpace NAS и получать сведения о хранилище через MCP. Командная строка zs предоставляет те же основные операции.
Что нужно для работы zspace-cli?
На macOS должен быть запущен клиент ZSpace, в котором выполнен вход. Сервер обращается к NAS через этот клиент.
