@andrebuzeli/git-mcp 6.3.0 → 6.3.2

package/dist/index.js

@@ -77,7 +77,7 @@ async function main() {
     // Create MCP Server with STDIO transport
     const server = new index_js_1.Server({
         name: '@andrebuzeli/git-mcp',
-        version: '6.3.0',
+        version: '6.3.2',
     });
     // Register tool list handler
     server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {

package/dist/resources/toolsGuide.js

@@ -10,10 +10,48 @@ exports.TOOLS_GUIDE = {
     name: "Git-MCP Tools Complete Guide",
     description: "Detailed documentation and usage instructions for all 20 Git tools with 102 actions",
     mimeType: "text/markdown",
-    content: `# 🛠️ Git-MCP v5.7.0 - Complete Tools Guide
+    content: `# 🛠️ Git-MCP v6.3.1 - Complete Tools Guide
 
-> **Comprehensive documentation for all 20 Git tools with 102 actions**
+> **Comprehensive documentation for all 21 Git tools with 110+ actions**
 > **Supports:** GitHub, Gitea, and Local Git operations
+> **NEW in v6.3.1:** git-fix tool for dual-provider migration
+
+---
+
+## ⚠️ CRITICAL: projectPath Requirements
+
+**ALL TOOLS REQUIRE projectPath PARAMETER**
+
+### ✅ Correct Usage:
+\\\`\\\`\\\`javascript
+{
+  "projectPath": "Z:/absolute/path/to/project-root"
+  // Must be the ROOT folder of the opened project
+  // NOT a subfolder, NOT a file, NOT a parent folder
+}
+\\\`\\\`\\\`
+
+### ❌ WRONG Usage:
+\\\`\\\`\\\`javascript
+// ❌ Relative path
+"projectPath": "./my-project"
+
+// ❌ Subfolder instead of root
+"projectPath": "/project-root/src"
+
+// ❌ Parent folder
+"projectPath": "/path/to/workspace"
+
+// ❌ File path
+"projectPath": "/project/package.json"
+\\\`\\\`\\\`
+
+### 📋 Rule:
+**projectPath MUST be:**
+- ✅ Absolute path (starts with / or drive letter)
+- ✅ Points to the ROOT folder of the opened project
+- ✅ The same folder you opened in your IDE
+- ✅ Contains .git folder (for Git operations)
 
 ---
 
@@ -22,13 +60,14 @@ exports.TOOLS_GUIDE = {
 1. [Quick Start](#quick-start)
 2. [Provider Types](#provider-types)
 3. [Core Workflow Tools](#core-workflow-tools)
-4. [Remote Management Tools](#remote-management-tools)
-5. [Issue & Pull Request Tools](#issue--pull-request-tools)
-6. [Release & Package Tools](#release--package-tools)
-7. [Branch & Tag Tools](#branch--tag-tools)
-8. [Configuration & Monitoring Tools](#configuration--monitoring-tools)
-9. [Advanced Tools](#advanced-tools)
-10. [Best Practices](#best-practices)
+4. [Migration Tools (NEW)](#migration-tools)
+5. [Remote Management Tools](#remote-management-tools)
+6. [Issue & Pull Request Tools](#issue--pull-request-tools)
+7. [Release & Package Tools](#release--package-tools)
+8. [Branch & Tag Tools](#branch--tag-tools)
+9. [Configuration & Monitoring Tools](#configuration--monitoring-tools)
+10. [Advanced Tools](#advanced-tools)
+11. [Best Practices](#best-practices)
 
 ---
 
@@ -91,6 +130,8 @@ npm install @andrebuzeli/git-mcp
 
 **Type:** HYBRID - Local operations + Remote operations (GitHub/Gitea)
 
+**projectPath:** ⚠️ REQUIRED - Absolute path to project ROOT folder (where you opened the project in IDE)
+
 **Actions:**
 - \`init\` - Initialize new repository
 - \`status\` - Check repository status
@@ -289,6 +330,138 @@ npm install @andrebuzeli/git-mcp
 
 ---
 
+## 🔧 Migration Tools (NEW in v6.3.1)
+
+### 21. **git-fix** (LOCAL)
+**Description:** Fix local Git repositories to work with dual-provider system (GitHub + Gitea)
+
+**Type:** LOCAL - Converts existing repos to dual-provider configuration
+
+**projectPath:** ⚠️ REQUIRED - Absolute path to project ROOT folder that needs fixing
+
+**Features:**
+- 🔍 **Auto-detection:** Automatically detects repository name from existing remotes
+- ✅ **Username correction:** Uses correct usernames from GITHUB_USERNAME and GITEA_USERNAME env vars
+- 🗑️ **Clean setup:** Removes old remotes and creates standardized configuration
+- 🔄 **Dual-push:** Configures origin to push to both GitHub and Gitea simultaneously
+- 📝 **Preserves history:** Keeps all commits and Git history intact
+- ⚙️ **.gitignore creation:** Creates standard .gitignore if missing
+
+**Parameters:**
+- \\\`projectPath\\\` (required) - Absolute path to Git repository ROOT folder
+- \\\`autoDetect\\\` (optional) - Auto-detect repo name from remotes (default: true)
+- \\\`githubRepo\\\` (optional) - GitHub repo in format "owner/repo" (auto-detected if not provided)
+- \\\`giteaRepo\\\` (optional) - Gitea repo in format "owner/repo" (auto-detected if not provided)
+
+**Requirements:**
+- \\\`GITHUB_USERNAME\\\` env var (REQUIRED)
+- \\\`GITEA_USERNAME\\\` env var (REQUIRED)
+- \\\`GITEA_URL\\\` env var (default: http://localhost:3000)
+
+**When to use:**
+- ✅ Existing Git repo NOT configured for dual-provider
+- ✅ Migrating from single remote (GitHub OR Gitea) to dual-push
+- ✅ Fixing incorrect username configuration
+- ✅ Standardizing repository configuration across projects
+
+**What it does:**
+1. ✅ Verifies/initializes Git repository
+2. 🔍 Captures current remotes (before state)
+3. 🔍 Auto-detects repository name from existing URLs
+4. 🗑️ Removes old remotes (origin, github, gitea)
+5. ➕ Adds new 'github' remote with correct username
+6. ➕ Adds new 'gitea' remote with correct username
+7. ⚙️ Configures 'origin' for dual-push (GitHub + Gitea)
+8. 📝 Creates .gitignore if missing
+9. 📊 Shows before/after comparison
+
+**Examples:**
+
+\\\`\\\`\\\`javascript
+// 1. Auto-detect and fix repository
+{
+  "tool": "git-fix",
+  "params": {
+    "projectPath": "Z:/my-old-project",
+    "autoDetect": true
+  }
+}
+
+// Before:
+// origin → https://github.com/olduser/old-project.git
+
+// After:
+// github → https://github.com/Your-GitHub-Username/old-project.git
+// gitea  → http://nas-ubuntu:9999/your-gitea-username/old-project.git
+// origin → dual-push to both
+
+// 2. Manual repo specification
+{
+  "tool": "git-fix",
+  "params": {
+    "projectPath": "Z:/my-project",
+    "githubRepo": "Andre-Buzeli/my-project",
+    "giteaRepo": "andrebuzeli/my-project",
+    "autoDetect": false
+  }
+}
+
+// 3. Fix multiple projects (use sequentially)
+// Project 1
+{
+  "tool": "git-fix",
+  "params": {
+    "projectPath": "Z:/project-1",
+    "autoDetect": true
+  }
+}
+
+// Project 2
+{
+  "tool": "git-fix",
+  "params": {
+    "projectPath": "Z:/project-2",
+    "autoDetect": true
+  }
+}
+\\\`\\\`\\\`
+
+**Result Structure:**
+\\\`\\\`\\\`json
+{
+  "success": true,
+  "projectPath": "Z:/my-project",
+  "fixed": [
+    "✅ Repositório Git válido encontrado",
+    "🔍 Nome do repo auto-detectado: my-project",
+    "✅ GitHub repo: Andre-Buzeli/my-project",
+    "✅ Gitea repo: andrebuzeli/my-project",
+    "🗑️  Removido remote antigo: origin",
+    "✅ Adicionado remote GitHub: https://github.com/Andre-Buzeli/my-project.git",
+    "✅ Adicionado remote Gitea: http://nas-ubuntu:9999/andrebuzeli/my-project.git",
+    "✅ Configurado origin para push dual (GitHub + Gitea)",
+    "✅ Histórico de commits preservado",
+    "✅ Criado .gitignore padrão"
+  ],
+  "warnings": [],
+  "errors": [],
+  "remotes": {
+    "before": [...],
+    "after": [...]
+  }
+}
+\\\`\\\`\\\`
+
+**⚠️ Important Notes:**
+- Always backup your repository before running git-fix
+- Requires valid GITHUB_USERNAME and GITEA_USERNAME env vars
+- Repository name detection works with github.com and Gitea URLs
+- Falls back to folder name if no remote detected
+- Does NOT push to remotes (only configures them)
+- Safe to run multiple times (idempotent)
+
+---
+
 ## 🌐 Remote Management Tools
 
 ### 5. **git-remote** (LOCAL)
@@ -1411,8 +1584,9 @@ for (const repo of repos) {
 | git-backup | LOCAL | 4 | Backup operations |
 | git-archive | LOCAL | 4 | Archive creation |
 | git-files | LOCAL | 4 | File operations |
+| **git-fix** | **LOCAL** | **1** | **Migrate repos to dual-provider (NEW v6.3.1)** |
 
-**Total: 20 tools, 102 actions**
+**Total: 21 tools, 110+ actions**
 
 ---
 
@@ -1485,7 +1659,7 @@ for (const repo of repos) {
 
 ---
 
-**Git-MCP v5.7.0** | Built with ❤️ for developers | 102 Actions | 20 Tools | 3 Provider Types
+**Git-MCP v6.3.1** | Built with ❤️ for developers | 110+ Actions | 21 Tools | 3 Provider Types | NEW: git-fix migration tool
 `
 };
 exports.default = exports.TOOLS_GUIDE;

package/dist/tools/gitFix.js

@@ -51,41 +51,56 @@ async function handleGitFix(args) {
         // Capturar remotes antes
         const remotesBefore = await git.getRemotes(true);
         result.remotes.before = remotesBefore.map(r => ({ name: r.name, url: r.refs.fetch || '' }));
+        // Obter usernames das env vars (OBRIGATÓRIO usar as credenciais fornecidas)
+        const githubUsername = process.env.GITHUB_USERNAME;
+        const giteaUsername = process.env.GITEA_USERNAME;
+        if (!githubUsername || !giteaUsername) {
+            throw new Error('GITHUB_USERNAME e GITEA_USERNAME são obrigatórios nas env vars');
+        }
         // Auto-detectar repos se solicitado
         let finalGithubRepo = githubRepo;
         let finalGiteaRepo = giteaRepo;
+        let detectedRepoName = null;
         if (autoDetect && remotesBefore.length > 0) {
             for (const remote of remotesBefore) {
                 const url = remote.refs.fetch || '';
-                if (url.includes('github.com') && !finalGithubRepo) {
-                    const match = url.match(/github\.com[:/]([^/]+)\/([^/.]+)/);
+                // Detectar APENAS o nome do repo (sem username)
+                if (url.includes('github.com') && !detectedRepoName) {
+                    const match = url.match(/github\.com[:/][^/]+\/([^/.]+)/);
                     if (match) {
-                        finalGithubRepo = `${match[1]}/${match[2]}`;
-                        result.fixed.push(`🔍 GitHub repo auto-detectado: ${finalGithubRepo}`);
+                        detectedRepoName = match[1];
+                        result.fixed.push(`🔍 Nome do repo auto-detectado: ${detectedRepoName}`);
                     }
                 }
-                if ((url.includes('nas-ubuntu') || url.includes('gitea')) && !finalGiteaRepo) {
-                    const match = url.match(/\/([^/]+)\/([^/.]+)(?:\.git)?$/);
+                // Detectar de Gitea
+                if ((url.includes('nas-ubuntu') || url.includes('gitea')) && !detectedRepoName) {
+                    const match = url.match(/\/[^/]+\/([^/.]+)(?:\.git)?$/);
                     if (match) {
-                        finalGiteaRepo = `${match[1]}/${match[2]}`;
-                        result.fixed.push(`🔍 Gitea repo auto-detectado: ${finalGiteaRepo}`);
+                        detectedRepoName = match[1];
+                        result.fixed.push(`🔍 Nome do repo auto-detectado: ${detectedRepoName}`);
                     }
                 }
             }
         }
-        // Obter username dos remotes existentes ou env vars
-        const githubUsername = process.env.GITHUB_USERNAME || 'andrebuzeli';
-        const giteaUsername = process.env.GITEA_USERNAME || 'andrebuzeli';
-        // Se não detectou repos, usar o nome da pasta
-        if (!finalGithubRepo) {
-            const folderName = path_1.default.basename(absolutePath);
-            finalGithubRepo = `${githubUsername}/${folderName}`;
-            result.warnings.push(`⚠️  GitHub repo não detectado - usando: ${finalGithubRepo}`);
+        // Construir repos usando os usernames CORRETOS das env vars
+        if (detectedRepoName) {
+            finalGithubRepo = finalGithubRepo || `${githubUsername}/${detectedRepoName}`;
+            finalGiteaRepo = finalGiteaRepo || `${giteaUsername}/${detectedRepoName}`;
+            result.fixed.push(`✅ GitHub repo: ${finalGithubRepo}`);
+            result.fixed.push(`✅ Gitea repo: ${finalGiteaRepo}`);
         }
-        if (!finalGiteaRepo) {
+        // Se não detectou repos, usar o nome da pasta
+        if (!finalGithubRepo || !finalGiteaRepo) {
             const folderName = path_1.default.basename(absolutePath);
-            finalGiteaRepo = `${giteaUsername}/${folderName}`;
-            result.warnings.push(`⚠️  Gitea repo não detectado - usando: ${finalGiteaRepo}`);
+            if (!finalGithubRepo) {
+                finalGithubRepo = `${githubUsername}/${folderName}`;
+            }
+            if (!finalGiteaRepo) {
+                finalGiteaRepo = `${giteaUsername}/${folderName}`;
+            }
+            result.warnings.push(`⚠️  Repo não detectado - usando nome da pasta: ${folderName}`);
+            result.fixed.push(`✅ GitHub repo: ${finalGithubRepo}`);
+            result.fixed.push(`✅ Gitea repo: ${finalGiteaRepo}`);
         }
         // Remover remotes antigos
         const remotesToRemove = ['origin', 'github', 'gitea'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrebuzeli/git-mcp",
-  "version": "6.3.0",
+  "version": "6.3.2",
   "description": "Professional MCP server for Git operations - STDIO UNIVERSAL: works in ANY IDE (Cursor, VSCode, Claude Desktop). Fully autonomous with intelligent error handling. Auto-detects branches, owner, repo. User-friendly error messages. Dual-provider execution (GitHub + Gitea)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",