export

目的

ワークスペースのポータブルな ZIP バックアップを作成します。アーカイブには設定ファイル、すべての spec ファイル、認証スクリプトが含まれます — 別のマシンでワークスペースを復元するために必要なすべてです。

使用するタイミング

• 変更を加える前にワークスペースをバックアップしたい場合
• swag2mcp を別のマシンに移行する場合
• API 設定を同僚と共有したい場合
• 再現可能な環境を準備する場合

構文

swag2mcp export [path] [output] [flags]

引数

引数	位置	必須	説明
path	1	いいえ	ワークスペースディレクトリ。省略時はパス解決ルールに従います。
output	2	いいえ	出力 ZIP ファイルのフルパス。省略時は ./swag2mcp-backup-<timestamp>.zip になります。

フラグ

フラグ	省略形	型	デフォルト	説明
--spec	-s	stringSlice	nil	指定された spec のみをエクスポート（カンマ区切り）

仕組み

デフォルトエクスポート

カレントディレクトリにタイムスタンプ付きの名前で ZIP を作成します：

swag2mcp export
# ./swag2mcp-backup-2026-07-22-143022.zip を作成

カスタム出力パス

swag2mcp export /path/to/workspace /path/to/backup.zip

特定の spec をエクスポート

swag2mcp export --spec meteo
swag2mcp export --spec meteo,store

ZIP の内容

エントリ	説明
swag2mcp.meta	エクスポートに関するメタデータ
swag2mcp.yaml	設定ファイル
specs/	すべての spec ファイル（OpenAPI/Swagger/Postman）
auth_scripts/	認証スクリプト
cache/	空（キャッシュはエクスポートされません）
responses/	空（レスポンスはエクスポートされません）

復元

バックアップから復元するには import を使用します：

swag2mcp import --from-zip /path/to/backup.zip

コマンド実行後の確認

ZIP ファイルが作成されたことを常に確認してください：

ls -la swag2mcp-backup-*.zip
# またはカスタム出力パスの場合：
ls -la /path/to/backup.zip

ニュアンス

• 出力はファイルパスである必要があります: [output] 引数は .zip で終わる完全なファイルパスである必要があります。ディレクトリを渡さないでください — ディレクトリパスが指定された場合、コマンドは ZIP を作成しません。
• デフォルトのファイル名: UTC タイムスタンプを使用した swag2mcp-backup-<YYYY-MM-DD-HHMMSS>.zip。
• --spec フィルター: 設定すると、指定された spec のみが含まれます。他の spec はアーカイブから除外されます。
• 設定不要: export は有効な設定ファイルがなくても動作します。ワークスペースに存在するものをエクスポートします。
• キャッシュとレスポンスは除外: これらは復元時に古くなる一時データです。設定、spec、認証スクリプトのみが保存されます。