@aithr-ai/mcp-server 1.0.14 → 1.0.16

package/index.js

@@ -583,6 +583,33 @@ class MCPServer {
           required: ['targetPath'],
         },
       },
+      {
+        name: 'aether_download_zip',
+        description: 'Download all project artifacts as a ZIP file to a local path. Extracts code files from artifacts and saves them in proper directory structure.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            targetPath: {
+              type: 'string',
+              description: 'Full path where to save the ZIP file (e.g., C:/Users/you/Downloads/project.zip)',
+            },
+            extractCode: {
+              type: 'boolean',
+              description: 'Extract code files from artifacts (default: true)',
+            },
+            includeRaw: {
+              type: 'boolean',
+              description: 'Include raw artifact markdown files (default: false)',
+            },
+            artifactIds: {
+              type: 'array',
+              items: { type: 'string' },
+              description: 'Specific artifact IDs to include (optional, includes all if not provided)',
+            },
+          },
+          required: ['targetPath'],
+        },
+      },
       // =========================================================================
       // Canvas Folder Tools
       // =========================================================================
@@ -1095,6 +1122,9 @@ class MCPServer {
         case 'aether_write_local':
           result = await this.writeLocal(args);
           break;
+        case 'aether_download_zip':
+          result = await this.downloadZip(args);
+          break;
         // Canvas Folder Tools
         case 'aether_list_folders':
           result = await this.listFolders(args);
@@ -2298,6 +2328,97 @@ class MCPServer {
     }
   }
 
+  /**
+   * Download all project artifacts as a ZIP file to a local path
+   */
+  async downloadZip(args) {
+    const projectId = config.projectId;
+
+    if (!projectId) {
+      return { error: 'No project ID configured. Set AETHER_PROJECT_ID environment variable.' };
+    }
+
+    const {
+      targetPath,
+      extractCode = true,
+      includeRaw = false,
+      artifactIds,
+    } = args;
+
+    if (!targetPath) {
+      return { error: 'targetPath is required - specify where to save the ZIP file (e.g., C:/Users/you/Downloads/project.zip)' };
+    }
+
+    // Ensure targetPath ends with .zip
+    const zipPath = targetPath.endsWith('.zip') ? targetPath : `${targetPath}.zip`;
+
+    try {
+      // Build query string
+      const params = new URLSearchParams();
+      params.set('extractCode', String(extractCode));
+      params.set('includeRaw', String(includeRaw));
+      if (artifactIds && artifactIds.length > 0) {
+        params.set('artifactIds', artifactIds.join(','));
+      }
+
+      // Fetch the ZIP from the download endpoint
+      const url = `${config.apiBaseUrl}/api/workspaces/${config.workspaceSlug}/projects/${projectId}/artifacts/download?${params.toString()}`;
+
+      const response = await fetch(url, {
+        headers: {
+          'Authorization': `Bearer ${config.apiKey}`,
+        },
+      });
+
+      if (!response.ok) {
+        const errorText = await response.text();
+        let errorMessage;
+        try {
+          const errorJson = JSON.parse(errorText);
+          errorMessage = errorJson.error || 'Failed to download ZIP';
+        } catch {
+          errorMessage = errorText || 'Failed to download ZIP';
+        }
+        return { error: errorMessage };
+      }
+
+      // Get file info from headers
+      const fileCount = response.headers.get('X-File-Count') || '0';
+      const artifactCount = response.headers.get('X-Artifact-Count') || '0';
+
+      // Get the ZIP data
+      const zipBuffer = await response.arrayBuffer();
+
+      // Ensure the directory exists
+      const path = await import('path');
+      const fs = await import('fs');
+      const dir = path.dirname(zipPath);
+
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+
+      // Write the ZIP file
+      fs.writeFileSync(zipPath, Buffer.from(zipBuffer));
+
+      const stats = fs.statSync(zipPath);
+
+      return {
+        success: true,
+        path: zipPath,
+        size: stats.size,
+        sizeFormatted: stats.size > 1024 * 1024
+          ? `${(stats.size / (1024 * 1024)).toFixed(2)} MB`
+          : `${(stats.size / 1024).toFixed(2)} KB`,
+        fileCount: parseInt(fileCount, 10),
+        artifactCount: parseInt(artifactCount, 10),
+        message: `ZIP file saved to ${zipPath} (${fileCount} files from ${artifactCount} artifacts)`,
+      };
+    } catch (e) {
+      return { error: e.message };
+    }
+  }
+
   /**
    * Write files directly to local disk (runs in MCP server, not Vercel)
    * Fetches files from generatedFiles API in batches and writes them locally

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aithr-ai/mcp-server",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "MCP server to connect Claude Code to Aether canvas - AI-powered team workspace for software development",
   "main": "index.js",
   "bin": {