@aithr-ai/mcp-server 1.0.6 → 1.0.8

package/README.md

@@ -14,14 +14,28 @@ claude mcp add --transport stdio aether \
 ```
 
 ### Windows
-```cmd
-claude mcp add --transport stdio aether ^
-  --env AETHER_API_KEY=YOUR_KEY ^
-  --env AETHER_WORKSPACE_ID=your-workspace ^
-  --env AETHER_PROJECT_ID=your-project-id ^
-  -s user -- cmd /c npx -y @aithr-ai/mcp-server
+
+Add this to your `~/.claude.json` file (in the `mcpServers` object):
+
+```json
+{
+  "mcpServers": {
+    "aether": {
+      "type": "stdio",
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "@aithr-ai/mcp-server"],
+      "env": {
+        "AETHER_API_KEY": "YOUR_KEY",
+        "AETHER_WORKSPACE_ID": "your-workspace",
+        "AETHER_PROJECT_ID": "your-project-id"
+      }
+    }
+  }
+}
 ```
 
+> **Note**: The `claude mcp add` command has a bug on Windows that drops the command args. Manual config is required.
+
 ## Get Your Credentials
 
 Visit [https://www.aithr.ai/settings/mcp-install](https://www.aithr.ai/settings/mcp-install) for personalized install commands with your API key and project ID.
@@ -43,7 +57,8 @@ Visit [https://www.aithr.ai/settings/mcp-install](https://www.aithr.ai/settings/
 ### GitHub Automation
 - `aether_automation_status` - Check what's ready to push
 - `aether_extract_files` - Extract code from artifacts
-- `aether_push_artifacts` - Push to GitHub (branch + commit + PR)
+- `aether_push_artifacts` - Push to GitHub via API (branch + commit + PR)
+- `aether_push_local` - **NEW** Push using local git (no rate limits, recommended for large pushes)
 
 ### Orchestra (Autonomous Development)
 - `aether_start_orchestra` - Start orchestration session

package/index.js

@@ -434,6 +434,45 @@ class MCPServer {
           },
         },
       },
+      {
+        name: 'aether_push_local',
+        description: 'Push artifacts to GitHub using local git (no rate limits). Requires a local clone of the repository. This is the recommended method for pushing many files.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            repoPath: {
+              type: 'string',
+              description: 'Path to local git repository (required)',
+            },
+            artifactIds: {
+              type: 'array',
+              items: { type: 'string' },
+              description: 'Specific artifact IDs to push (optional, uses all parseable if not provided)',
+            },
+            branchName: {
+              type: 'string',
+              description: 'Branch name (auto-generated if not provided)',
+            },
+            commitMessage: {
+              type: 'string',
+              description: 'Commit message (default: "feat: Add generated code from Aether AI")',
+            },
+            prTitle: {
+              type: 'string',
+              description: 'Pull request title (optional, creates PR if provided)',
+            },
+            prBody: {
+              type: 'string',
+              description: 'Pull request body/description',
+            },
+            createPR: {
+              type: 'boolean',
+              description: 'Create a pull request after pushing (default: true)',
+            },
+          },
+          required: ['repoPath'],
+        },
+      },
       // =========================================================================
       // Canvas Folder Tools
       // =========================================================================
@@ -934,6 +973,9 @@ class MCPServer {
         case 'aether_push_artifacts':
           result = await this.pushArtifacts(args);
           break;
+        case 'aether_push_local':
+          result = await this.pushLocal(args);
+          break;
         // Canvas Folder Tools
         case 'aether_list_folders':
           result = await this.listFolders(args);
@@ -1644,6 +1686,264 @@ class MCPServer {
     }
   }
 
+  /**
+   * Push artifacts using local git (no API rate limits)
+   * This writes files to a local git repo and uses git CLI to push
+   */
+  async pushLocal(args) {
+    const {
+      repoPath,
+      artifactIds,
+      branchName,
+      commitMessage = 'feat: Add generated code from Aether AI',
+      prTitle,
+      prBody,
+      createPR = true,
+    } = args;
+
+    const projectId = config.projectId;
+    if (!projectId) {
+      return { error: 'No project ID configured. Set AETHER_PROJECT_ID environment variable.' };
+    }
+
+    if (!repoPath) {
+      return { error: 'repoPath is required - path to local git repository' };
+    }
+
+    const { execSync, spawnSync } = require('child_process');
+    const fs = require('fs');
+    const path = require('path');
+
+    // Verify repo path exists and is a git repo
+    if (!fs.existsSync(repoPath)) {
+      return { error: `Repository path does not exist: ${repoPath}` };
+    }
+    if (!fs.existsSync(path.join(repoPath, '.git'))) {
+      return { error: `Not a git repository: ${repoPath}` };
+    }
+
+    try {
+      // Get artifacts and extract files via API (dry run to get file list)
+      const dryRunData = await this.mcpApiCall(
+        `/mcp/projects/${projectId}/push-artifacts`,
+        'POST',
+        {
+          artifactIds,
+          dryRun: true,
+        }
+      );
+
+      if (!dryRunData.wouldPush || !dryRunData.wouldPush.files) {
+        return { error: 'No files to push', details: dryRunData };
+      }
+
+      const files = dryRunData.wouldPush.files;
+      const branch = branchName || dryRunData.wouldPush.branch || `aether-${Date.now().toString(36)}`;
+
+      // Get current branch to return to later
+      const originalBranch = execSync('git rev-parse --abbrev-ref HEAD', {
+        cwd: repoPath,
+        encoding: 'utf-8'
+      }).trim();
+
+      // Fetch latest and create/checkout branch
+      try {
+        execSync('git fetch origin', { cwd: repoPath, stdio: 'pipe' });
+      } catch (e) {
+        // Fetch might fail if no remote, continue anyway
+      }
+
+      // Check if branch exists remotely or locally
+      let branchExists = false;
+      try {
+        execSync(`git rev-parse --verify ${branch}`, { cwd: repoPath, stdio: 'pipe' });
+        branchExists = true;
+      } catch (e) {
+        // Branch doesn't exist locally
+      }
+
+      if (branchExists) {
+        execSync(`git checkout ${branch}`, { cwd: repoPath, stdio: 'pipe' });
+      } else {
+        // Create new branch from current HEAD (or main/master)
+        execSync(`git checkout -b ${branch}`, { cwd: repoPath, stdio: 'pipe' });
+      }
+
+      // Get artifact content and write files
+      // We need to fetch the actual file contents from the artifacts
+      let totalFiles = 0;
+      const writtenFiles = [];
+
+      // Fetch all artifacts to get their content
+      const artifactsData = await this.mcpApiCall(`/mcp/projects/${projectId}/artifacts`);
+      const artifactMap = new Map();
+      for (const a of (artifactsData.artifacts || [])) {
+        if (!artifactIds || artifactIds.length === 0 || artifactIds.includes(a.id)) {
+          // Get full artifact content
+          const fullArtifact = await this.mcpApiCall(`/mcp/projects/${projectId}/artifacts/${a.id}`);
+          if (fullArtifact.content) {
+            artifactMap.set(a.id, fullArtifact);
+          }
+        }
+      }
+
+      // Parse artifacts and write files
+      for (const [artifactId, artifact] of artifactMap) {
+        const parsedFiles = this.parseCodeBlocks(artifact.content);
+
+        for (const file of parsedFiles) {
+          const filePath = path.join(repoPath, file.path);
+          const dirPath = path.dirname(filePath);
+
+          // Create directory if needed
+          if (!fs.existsSync(dirPath)) {
+            fs.mkdirSync(dirPath, { recursive: true });
+          }
+
+          // Write file
+          fs.writeFileSync(filePath, file.content, 'utf-8');
+          writtenFiles.push(file.path);
+          totalFiles++;
+        }
+      }
+
+      if (totalFiles === 0) {
+        // Checkout back to original branch
+        execSync(`git checkout ${originalBranch}`, { cwd: repoPath, stdio: 'pipe' });
+        return { error: 'No files could be extracted from artifacts' };
+      }
+
+      // Stage all changes
+      execSync('git add -A', { cwd: repoPath, stdio: 'pipe' });
+
+      // Check if there are changes to commit
+      const status = execSync('git status --porcelain', { cwd: repoPath, encoding: 'utf-8' });
+      if (!status.trim()) {
+        execSync(`git checkout ${originalBranch}`, { cwd: repoPath, stdio: 'pipe' });
+        return {
+          success: false,
+          message: 'No changes to commit - files may already exist',
+          filesProcessed: totalFiles,
+        };
+      }
+
+      // Commit
+      const commitMsg = `${commitMessage}\n\n🤖 Generated with Aether AI`;
+      execSync(`git commit -m "${commitMsg.replace(/"/g, '\\"')}"`, { cwd: repoPath, stdio: 'pipe' });
+
+      // Get commit SHA
+      const commitSha = execSync('git rev-parse HEAD', { cwd: repoPath, encoding: 'utf-8' }).trim();
+
+      // Push to remote
+      try {
+        execSync(`git push -u origin ${branch}`, { cwd: repoPath, stdio: 'pipe' });
+      } catch (pushError) {
+        return {
+          success: false,
+          error: `Push failed: ${pushError.message}`,
+          hint: 'Make sure you have push access to the repository',
+          branch,
+          commitSha,
+          filesWritten: totalFiles,
+        };
+      }
+
+      // Create PR via API if requested
+      let prResult = null;
+      if (createPR && prTitle) {
+        try {
+          // We need to call GitHub API to create PR
+          // Get repo info from git remote
+          const remoteUrl = execSync('git remote get-url origin', { cwd: repoPath, encoding: 'utf-8' }).trim();
+          const repoMatch = remoteUrl.match(/github\.com[:/](.+?)(?:\.git)?$/);
+
+          if (repoMatch) {
+            const repoFullName = repoMatch[1].replace(/\.git$/, '');
+
+            // Create PR via Aether's API (which has the GitHub token)
+            prResult = await this.mcpApiCall(
+              `/mcp/projects/${projectId}/github/pull-request`,
+              'POST',
+              {
+                headBranch: branch,
+                title: prTitle,
+                body: prBody || `## Summary\n\nGenerated ${totalFiles} files from Aether AI.\n\n🤖 Generated with Aether`,
+              }
+            );
+          }
+        } catch (prError) {
+          // PR creation failed but push succeeded
+          prResult = { error: prError.message };
+        }
+      }
+
+      // Checkout back to original branch
+      try {
+        execSync(`git checkout ${originalBranch}`, { cwd: repoPath, stdio: 'pipe' });
+      } catch (e) {
+        // Ignore checkout errors
+      }
+
+      return {
+        success: true,
+        method: 'local_git',
+        branch,
+        commit: {
+          sha: commitSha,
+          message: commitMessage,
+        },
+        filesWritten: totalFiles,
+        files: writtenFiles.slice(0, 20), // First 20 files
+        pullRequest: prResult,
+        message: `Successfully pushed ${totalFiles} files to ${branch} using local git`,
+      };
+
+    } catch (e) {
+      return {
+        error: e.message,
+        hint: 'Make sure the repository path is correct and you have git installed',
+      };
+    }
+  }
+
+  /**
+   * Parse code blocks from artifact content
+   */
+  parseCodeBlocks(content) {
+    const files = [];
+    if (!content) return files;
+
+    // Match ```language:path/to/file or ```path/to/file patterns
+    const codeBlockRegex = /```(?:(\w+):)?([^\s`]+)\n([\s\S]*?)```/g;
+    let match;
+
+    while ((match = codeBlockRegex.exec(content)) !== null) {
+      const language = match[1] || '';
+      const filePath = match[2];
+      const code = match[3];
+
+      // Skip if path looks invalid
+      if (!filePath || filePath.includes('`') || filePath.length > 200) {
+        continue;
+      }
+
+      // Clean up path
+      const cleanPath = filePath
+        .replace(/^\//, '') // Remove leading slash
+        .replace(/\.\.\//g, ''); // Remove ../ for security
+
+      if (cleanPath && code) {
+        files.push({
+          path: cleanPath,
+          language,
+          content: code.trim(),
+        });
+      }
+    }
+
+    return files;
+  }
+
   // =========================================================================
   // Canvas Folder Tool Implementations
   // =========================================================================

package/package.json

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