Экспорт и импорт

Обзор

swag2mcp поддерживает полный цикл рабочей области через ZIP-архивы. Вы можете экспортировать всю рабочую область (конфиг, файлы спецификаций, скрипты аутентификации) в ZIP-файл и восстановить её на другой машине.

Экспорт

Создаёт портативную ZIP-резервную копию вашей рабочей области.

# Экспорт в файл по умолчанию (swag2mcp-backup-<timestamp>.zip)
swag2mcp export

# Экспорт с пользовательским путём
swag2mcp export ~/backups/swag2mcp-backup.zip

# Экспорт только определённых спецификаций
swag2mcp export --spec meteo
swag2mcp export --spec meteo,store

Что входит в экспорт

Элемент	Описание
swag2mcp.yaml	Конфигурационный файл
specs/	Все файлы спецификаций (OpenAPI/Swagger/Postman)
auth_scripts/	Скрипты аутентификации
swag2mcp.meta	Метаданные (информация о версии для совместимости)

Кэш и ответы не экспортируются — они временны и будут устаревшими при восстановлении.

Имя файла по умолчанию

Если вы не указали путь вывода, файл сохраняется как swag2mcp-backup-<YYYY-MM-DD-HHMMSS>.zip в текущей директории (UTC-метка времени).

Импорт

Восстановление рабочей области из ZIP-резервной копии или импорт файлов спецификаций.

Восстановление из ZIP

# Восстановление полной рабочей области
swag2mcp import --from-zip /path/to/backup.zip

# Восстановление
swag2mcp import --from-zip /path/to/backup.zip

ZIP должен быть создан командой swag2mcp export — произвольные ZIP-файлы не будут работать.

Импорт одного файла спецификации

Скачайте файл спецификации и сохраните его в specs/:

swag2mcp import https://example.com/spec.yaml example-api.yaml
swag2mcp import /path/to/workspace https://example.com/spec.yaml example-api.yaml

Пакетный импорт из существующего конфига (--spec)

Скачайте все файлы спецификаций коллекций для указанных доменов из их настроенных URL location, сохраните в specs/ и обновите конфиг, чтобы он указывал на локальные копии:

swag2mcp import --spec meteo
swag2mcp import /path/to/workspace --spec meteo,github

После этого рабочая область становится самодостаточной — удалённые URL спецификаций больше не нужны.

Варианты использования

Резервное копирование

swag2mcp export swag2mcp-$(date +%Y-%m-%d).zip

Перенос на другую машину

# На старой машине
swag2mcp export swag2mcp.zip

# Скопируйте ZIP на новую машину, затем:
swag2mcp import --from-zip swag2mcp.zip

Обмен конфигурацией

swag2mcp init
swag2mcp export template.zip
# Поделитесь template.zip с коллегой

Проверка после экспорта

Всегда проверяйте, что ZIP-файл был создан:

ls -la swag2mcp-backup-*.zip

Важные замечания

• Вывод должен быть путём к файлу, оканчивающимся на .zip — не передавайте директорию
• Кэш и ответы исключены — сохраняются только конфиг, спецификации и скрипты аутентификации
• ZIP самодостаточен — его можно восстановить на любой машине с установленным swag2mcp
• Фильтр спецификаций — используйте --spec для экспорта или импорта только определённых спецификаций