@andrebuzeli/git-mcp 6.3.1 → 7.0.0

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.1',
+        version: '6.3.2',
     });
     // Register tool list handler
     server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {

package/dist/resources/toolsGuide.js

@@ -10,10 +10,68 @@ 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 v7.0.0 - Complete Tools Guide
 
-> **Comprehensive documentation for all 20 Git tools with 102 actions**
-> **Supports:** GitHub, Gitea, and Local Git operations
+> **Comprehensive documentation for all 21 Git tools with 110+ actions**
+> **Supports:** Automatic DUAL execution on GitHub + Gitea APIs
+> **BREAKING CHANGES in v7.0.0:** ALL tools now execute DUAL automatically with env var usernames
+
+---
+
+## 🚀 v7.0.0 MAJOR UPDATE: AUTOMATIC DUAL EXECUTION
+
+**ALL TOOLS NOW:**
+- ✅ Execute on BOTH GitHub and Gitea APIs automatically
+- ✅ Use GITHUB_USERNAME and GITEA_USERNAME from environment variables
+- ✅ Return separated responses: \`{ github: {...}, gitea: {...} }\`
+- ✅ NO manual owner/user/author parameters needed
+- ✅ Each provider uses its own credentials automatically
+
+### Environment Variables Required:
+\\\`\\\`\\\`bash
+GITHUB_TOKEN=your_github_token
+GITHUB_USERNAME=YourGitHubUsername
+GITEA_TOKEN=your_gitea_token
+GITEA_USERNAME=yourGiteaUsername
+GITEA_URL=http://your-gitea-server:port
+\\\`\\\`\\\`
+
+---
+
+## ⚠️ 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 +80,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 +150,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 +350,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 +1604,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 +1679,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/gitAnalytics.d.ts

@@ -2,28 +2,5 @@ import { Tool, MCPContext } from '../types';
 export declare class GitAnalyticsTool implements Tool {
     name: string;
     description: string;
-    handle(params: Record<string, any>, ctx: MCPContext): Promise<{
-        success: boolean;
-        stats: {
-            totalCommits: number;
-            branches: number;
-            tags: number;
-            latestCommit: (import("simple-git").DefaultLogFields & import("simple-git").ListLogLine) | null;
-        };
-        commits?: undefined;
-        details?: undefined;
-        contributors?: undefined;
-    } | {
-        success: boolean;
-        commits: number;
-        details: readonly (import("simple-git").DefaultLogFields & import("simple-git").ListLogLine)[];
-        stats?: undefined;
-        contributors?: undefined;
-    } | {
-        success: boolean;
-        contributors: any[];
-        stats?: undefined;
-        commits?: undefined;
-        details?: undefined;
-    }>;
+    handle(params: Record<string, any>, ctx: MCPContext): Promise<any>;
 }

package/dist/tools/gitAnalytics.js

@@ -4,65 +4,190 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GitAnalyticsTool = void 0;
-const simple_git_1 = __importDefault(require("simple-git"));
 const errors_1 = require("../utils/errors");
+const axios_1 = __importDefault(require("axios"));
+const repoHelpers_1 = require("../utils/repoHelpers");
 class GitAnalyticsTool {
     constructor() {
         this.name = 'git-analytics';
-        this.description = 'Repository analytics and statistics';
+        this.description = 'Repository analytics and statistics - automatic dual-provider execution using GitHub and Gitea APIs';
     }
     async handle(params, ctx) {
         const action = params.action;
         const projectPath = params.projectPath;
-        if (!action || !projectPath) {
-            throw new errors_1.MCPError('VALIDATION_ERROR', 'action and projectPath are required');
-        }
-        const git = (0, simple_git_1.default)({ baseDir: projectPath });
+        if (!action)
+            throw new errors_1.MCPError('VALIDATION_ERROR', 'action is required');
+        if (!projectPath)
+            throw new errors_1.MCPError('VALIDATION_ERROR', 'projectPath is required');
+        // Auto-extract repo info from projectPath
+        const repoInfo = (0, repoHelpers_1.getRepoInfo)(projectPath);
+        const repo = repoInfo.repoName;
+        // Each provider uses its own username from env
+        const githubOwner = process.env.GITHUB_USERNAME;
+        const giteaOwner = process.env.GITEA_USERNAME;
         switch (action) {
             case 'stats': {
-                const log = await git.log();
-                const branches = await git.branch();
-                const tags = await git.tags();
-                return {
-                    success: true,
-                    stats: {
-                        totalCommits: log.total,
-                        branches: branches.all.length,
-                        tags: tags.all.length,
-                        latestCommit: log.latest,
-                    },
-                };
+                const results = { success: true, providers: {} };
+                // GitHub API
+                if (ctx.providerManager.github && githubOwner) {
+                    try {
+                        const repoData = await ctx.providerManager.github.rest.repos.get({
+                            owner: githubOwner,
+                            repo: repo,
+                        });
+                        const branches = await ctx.providerManager.github.rest.repos.listBranches({
+                            owner: githubOwner,
+                            repo: repo,
+                        });
+                        const tags = await ctx.providerManager.github.rest.repos.listTags({
+                            owner: githubOwner,
+                            repo: repo,
+                        });
+                        const commits = await ctx.providerManager.github.rest.repos.listCommits({
+                            owner: githubOwner,
+                            repo: repo,
+                            per_page: 1,
+                        });
+                        results.providers.github = {
+                            success: true,
+                            stats: {
+                                totalCommits: repoData.data.size,
+                                branches: branches.data.length,
+                                tags: tags.data.length,
+                                defaultBranch: repoData.data.default_branch,
+                                latestCommit: commits.data[0] || null,
+                                size: repoData.data.size,
+                                language: repoData.data.language,
+                                stars: repoData.data.stargazers_count,
+                                forks: repoData.data.forks_count,
+                                openIssues: repoData.data.open_issues_count,
+                            },
+                        };
+                    }
+                    catch (err) {
+                        results.providers.github = { success: false, error: err.message };
+                    }
+                }
+                // Gitea API
+                if (ctx.providerManager.giteaBaseUrl && giteaOwner) {
+                    try {
+                        const repoData = await axios_1.default.get(`${ctx.providerManager.giteaBaseUrl}/api/v1/repos/${giteaOwner}/${repo}`, { headers: { Authorization: `token ${ctx.providerManager.giteaToken}` } });
+                        const branches = await axios_1.default.get(`${ctx.providerManager.giteaBaseUrl}/api/v1/repos/${giteaOwner}/${repo}/branches`, { headers: { Authorization: `token ${ctx.providerManager.giteaToken}` } });
+                        const tags = await axios_1.default.get(`${ctx.providerManager.giteaBaseUrl}/api/v1/repos/${giteaOwner}/${repo}/tags`, { headers: { Authorization: `token ${ctx.providerManager.giteaToken}` } });
+                        const commits = await axios_1.default.get(`${ctx.providerManager.giteaBaseUrl}/api/v1/repos/${giteaOwner}/${repo}/commits`, {
+                            params: { limit: 1 },
+                            headers: { Authorization: `token ${ctx.providerManager.giteaToken}` }
+                        });
+                        results.providers.gitea = {
+                            success: true,
+                            stats: {
+                                totalCommits: repoData.data.size,
+                                branches: branches.data.length,
+                                tags: tags.data.length,
+                                defaultBranch: repoData.data.default_branch,
+                                latestCommit: commits.data[0] || null,
+                                size: repoData.data.size,
+                                language: repoData.data.language,
+                                stars: repoData.data.stars_count,
+                                forks: repoData.data.forks_count,
+                                openIssues: repoData.data.open_issues_count,
+                            },
+                        };
+                    }
+                    catch (err) {
+                        results.providers.gitea = { success: false, error: err.message };
+                    }
+                }
+                return results;
             }
             case 'commits': {
-                const since = params.since;
-                const until = params.until;
-                const log = await git.log({
-                    from: since,
-                    to: until,
-                    maxCount: params.limit || 1000,
-                });
-                return {
-                    success: true,
-                    commits: log.all.length,
-                    details: log.all,
-                };
+                const results = { success: true, providers: {} };
+                // GitHub API
+                if (ctx.providerManager.github && githubOwner) {
+                    try {
+                        const commits = await ctx.providerManager.github.rest.repos.listCommits({
+                            owner: githubOwner,
+                            repo: repo,
+                            since: params.since,
+                            until: params.until,
+                            per_page: params.limit || 100,
+                        });
+                        results.providers.github = {
+                            success: true,
+                            commits: commits.data.length,
+                            details: commits.data,
+                        };
+                    }
+                    catch (err) {
+                        results.providers.github = { success: false, error: err.message };
+                    }
+                }
+                // Gitea API
+                if (ctx.providerManager.giteaBaseUrl && giteaOwner) {
+                    try {
+                        const commits = await axios_1.default.get(`${ctx.providerManager.giteaBaseUrl}/api/v1/repos/${giteaOwner}/${repo}/commits`, {
+                            params: {
+                                since: params.since,
+                                until: params.until,
+                                limit: params.limit || 100,
+                            },
+                            headers: { Authorization: `token ${ctx.providerManager.giteaToken}` }
+                        });
+                        results.providers.gitea = {
+                            success: true,
+                            commits: commits.data.length,
+                            details: commits.data,
+                        };
+                    }
+                    catch (err) {
+                        results.providers.gitea = { success: false, error: err.message };
+                    }
+                }
+                return results;
             }
             case 'contributors': {
-                const log = await git.log();
-                const contributors = new Map();
-                log.all.forEach(commit => {
-                    const author = commit.author_name;
-                    if (contributors.has(author)) {
-                        contributors.get(author).count++;
+                const results = { success: true, providers: {} };
+                // GitHub API
+                if (ctx.providerManager.github && githubOwner) {
+                    try {
+                        const contributors = await ctx.providerManager.github.rest.repos.listContributors({
+                            owner: githubOwner,
+                            repo: repo,
+                            per_page: 100,
+                        });
+                        results.providers.github = {
+                            success: true,
+                            contributors: contributors.data.map((c) => ({
+                                login: c.login,
+                                name: c.login,
+                                contributions: c.contributions,
+                                avatar_url: c.avatar_url,
+                            })),
+                        };
+                    }
+                    catch (err) {
+                        results.providers.github = { success: false, error: err.message };
+                    }
+                }
+                // Gitea API
+                if (ctx.providerManager.giteaBaseUrl && giteaOwner) {
+                    try {
+                        const contributors = await axios_1.default.get(`${ctx.providerManager.giteaBaseUrl}/api/v1/repos/${giteaOwner}/${repo}/contributors`, { headers: { Authorization: `token ${ctx.providerManager.giteaToken}` } });
+                        results.providers.gitea = {
+                            success: true,
+                            contributors: contributors.data.map((c) => ({
+                                login: c.login,
+                                name: c.name || c.login,
+                                contributions: c.contributions,
+                                avatar_url: c.avatar_url,
+                            })),
+                        };
                     }
-                    else {
-                        contributors.set(author, { name: author, email: commit.author_email, count: 1 });
+                    catch (err) {
+                        results.providers.gitea = { success: false, error: err.message };
                     }
-                });
-                return {
-                    success: true,
-                    contributors: Array.from(contributors.values()).sort((a, b) => b.count - a.count),
-                };
+                }
+                return results;
             }
             default:
                 throw new errors_1.MCPError('VALIDATION_ERROR', `Unsupported action: ${action}`);

package/dist/tools/gitBranches.d.ts

@@ -2,71 +2,5 @@ import { Tool, MCPContext } from '../types';
 export declare class GitBranchesTool implements Tool {
     name: string;
     description: string;
-    handle(params: Record<string, any>, ctx: MCPContext): Promise<{
-        success: boolean;
-        branch: any;
-        branches?: undefined;
-        current?: undefined;
-        deleted?: undefined;
-        result?: undefined;
-        baseBranch?: undefined;
-        compareBranch?: undefined;
-        commits?: undefined;
-        diff?: undefined;
-    } | {
-        branches: string[];
-        current: string;
-        success?: undefined;
-        branch?: undefined;
-        deleted?: undefined;
-        result?: undefined;
-        baseBranch?: undefined;
-        compareBranch?: undefined;
-        commits?: undefined;
-        diff?: undefined;
-    } | {
-        success: boolean;
-        branch: string;
-        current: boolean;
-        branches?: undefined;
-        deleted?: undefined;
-        result?: undefined;
-        baseBranch?: undefined;
-        compareBranch?: undefined;
-        commits?: undefined;
-        diff?: undefined;
-    } | {
-        success: boolean;
-        deleted: any;
-        branch?: undefined;
-        branches?: undefined;
-        current?: undefined;
-        result?: undefined;
-        baseBranch?: undefined;
-        compareBranch?: undefined;
-        commits?: undefined;
-        diff?: undefined;
-    } | {
-        success: boolean;
-        result: import("simple-git").MergeResult;
-        branch?: undefined;
-        branches?: undefined;
-        current?: undefined;
-        deleted?: undefined;
-        baseBranch?: undefined;
-        compareBranch?: undefined;
-        commits?: undefined;
-        diff?: undefined;
-    } | {
-        success: boolean;
-        baseBranch: any;
-        compareBranch: any;
-        commits: readonly (import("simple-git").DefaultLogFields & import("simple-git").ListLogLine)[];
-        diff: string;
-        branch?: undefined;
-        branches?: undefined;
-        current?: undefined;
-        deleted?: undefined;
-        result?: undefined;
-    }>;
+    handle(params: Record<string, any>, ctx: MCPContext): Promise<any>;
 }