@andrebuzeli/git-mcp 7.3.3 → 7.4.0

package/README.md

@@ -1,11 +1,34 @@
 # GIT MCP Server
 
-Professional MCP (Model Context Protocol) server for Git operations with multi-provider support, enhanced security, comprehensive safety features, and **self-documenting resources**.
+Professional MCP (Model Context Protocol) server for Git operations with multi-provider support, enhanced security, comprehensive safety features, and **universal IDE compatibility**.
+
+## ✨ NEW in v7.4.0 - Universal IDE Compatibility
+
+**🎉 Now works with ALL IDEs and AI agents without parameter errors!**
+
+- ✅ **VSCode** (all AI extensions)
+- ✅ **Cursor AI**
+- ✅ **Trae AI**
+- ✅ **Kiro.dev**
+- ✅ **Claude Desktop**
+- ✅ **Any MCP-compatible client**
+
+### Problem Solved
+Previously, different IDEs sent parameters in different formats causing `Error: action is required`. Now Git-MCP **automatically normalizes** parameters from any source!
+
+```javascript
+// ALL these formats work now! ✅
+{ "command": "git status", "projectPath": "..." }  // IDE format
+{ "action": "status", "projectPath": "..." }        // Standard format
+{ "command": "status", "projectPath": "..." }       // Simple format
+{ "projectPath": "..." }                             // Auto-detect (defaults to status)
+```
 
 ## Features
 
-- 🚀 **20 Specialized Git Tools** - Complete Git workflow coverage with safety warnings
-- 📚 **NEW: Self-Documenting Resources** - Complete documentation via MCP protocol
+- 🌐 **NEW: Universal Parameter Normalization** - Accepts both 'action' and 'command' formats
+- 🚀 **23 Specialized Git Tools** - Complete Git workflow coverage with 170+ actions
+- 📚 **Self-Documenting Resources** - Complete documentation via MCP protocol
 - ⚡ **3 Powerful Tools with Full Traceability**
   - **git-upload** - Upload complete projects to GitHub + Gitea automatically
   - **git-update** - Complete update workflow (add + commit + push) with tracking
@@ -15,7 +38,7 @@ Professional MCP (Model Context Protocol) server for Git operations with multi-p
 - 🚨 **Safety Warnings** - Comprehensive warnings for destructive operations
 - 🛡️ **Enhanced Error Handling** - Detailed diagnostics with actionable solutions
 - 📋 **Comprehensive Validation** - Pre-execution validation with helpful guidance
-- 🔧 **IDE/Client Compatibility** - Universal aliases for different MCP client expectations
+- 🔧 **IDE/Client Compatibility** - Works seamlessly with ANY IDE or AI agent
 - 📦 **NPM Distribution** - Easy installation via npx
 - 🤖 **AI Agent Integration** - Designed for AI agent workflows with safety controls
 - 📊 **Full Traceability** - Every operation tracked locally and remotely

package/dist/tools/gitAnalytics.js

@@ -1,12 +1,13 @@
 import { MCPError } from '../utils/errors.js';
 import axios from 'axios';
-import { getRepoInfo } from '../utils/repoHelpers.js';
+import { getRepoInfo, normalizeToolParams } from '../utils/repoHelpers.js';
 export class GitAnalyticsTool {
     constructor() {
         this.name = 'git-analytics';
         this.description = 'Repository analytics and statistics - automatic dual-provider execution using GitHub and Gitea APIs';
     }
     async handle(params, ctx) {
+        params = normalizeToolParams(params);
         const action = params.action;
         const projectPath = params.projectPath;
         if (!action)

package/dist/tools/gitConfig.d.ts

@@ -9,6 +9,10 @@ export declare class GitConfigTool implements Tool {
         message?: undefined;
         scope?: undefined;
         configs?: undefined;
+        configFile?: undefined;
+        content?: undefined;
+        lines?: undefined;
+        note?: undefined;
     } | {
         success: boolean;
         key: any;
@@ -16,6 +20,10 @@ export declare class GitConfigTool implements Tool {
         value?: undefined;
         scope?: undefined;
         configs?: undefined;
+        configFile?: undefined;
+        content?: undefined;
+        lines?: undefined;
+        note?: undefined;
     } | {
         success: boolean;
         scope: string;
@@ -23,6 +31,10 @@ export declare class GitConfigTool implements Tool {
         key?: undefined;
         value?: undefined;
         message?: undefined;
+        configFile?: undefined;
+        content?: undefined;
+        lines?: undefined;
+        note?: undefined;
     } | {
         success: boolean;
         key: any;
@@ -30,5 +42,20 @@ export declare class GitConfigTool implements Tool {
         scope: string | undefined;
         message?: undefined;
         configs?: undefined;
+        configFile?: undefined;
+        content?: undefined;
+        lines?: undefined;
+        note?: undefined;
+    } | {
+        success: boolean;
+        configFile: string;
+        scope: string;
+        content: string;
+        lines: number;
+        message: string;
+        note: string;
+        key?: undefined;
+        value?: undefined;
+        configs?: undefined;
     }>;
 }

package/dist/tools/gitConfig.js

@@ -1,5 +1,7 @@
 import simpleGit from 'simple-git';
 import { MCPError } from '../utils/errors.js';
+import * as fs from 'fs/promises';
+import * as path from 'path';
 export class GitConfigTool {
     constructor() {
         this.name = 'git-config';
@@ -57,8 +59,30 @@ export class GitConfigTool {
                     scope: params.showScope ? scope : undefined,
                 };
             }
-            case 'edit':
-                throw new MCPError('NOT_IMPLEMENTED', 'Edit action requires manual editing of config file');
+            case 'edit': {
+                // Return config file path and instructions for manual editing
+                const configFile = scope === 'global'
+                    ? path.join(require('os').homedir(), '.gitconfig')
+                    : scope === 'system'
+                        ? '/etc/gitconfig'
+                        : path.join(projectPath, '.git', 'config');
+                try {
+                    await fs.access(configFile);
+                    const content = await fs.readFile(configFile, 'utf-8');
+                    return {
+                        success: true,
+                        configFile,
+                        scope,
+                        content,
+                        lines: content.split('\n').length,
+                        message: 'Config file content retrieved. Edit and use "set" action to update values.',
+                        note: 'For direct file editing, use your preferred text editor',
+                    };
+                }
+                catch (error) {
+                    throw new MCPError('FILE_ERROR', `Config file not accessible: ${error.message}`);
+                }
+            }
             default:
                 throw new MCPError('VALIDATION_ERROR', `Unsupported action: ${action}`);
         }

package/dist/tools/gitFiles.d.ts

@@ -7,6 +7,10 @@ export declare class GitFilesTool implements Tool {
         path: string;
         content: string;
         files?: undefined;
+        created?: undefined;
+        size?: undefined;
+        updated?: undefined;
+        deleted?: undefined;
         matches?: undefined;
         count?: undefined;
     } | {
@@ -14,6 +18,43 @@ export declare class GitFilesTool implements Tool {
         files: string[];
         path?: undefined;
         content?: undefined;
+        created?: undefined;
+        size?: undefined;
+        updated?: undefined;
+        deleted?: undefined;
+        matches?: undefined;
+        count?: undefined;
+    } | {
+        success: boolean;
+        created: boolean;
+        path: string;
+        size: any;
+        content?: undefined;
+        files?: undefined;
+        updated?: undefined;
+        deleted?: undefined;
+        matches?: undefined;
+        count?: undefined;
+    } | {
+        success: boolean;
+        updated: boolean;
+        path: string;
+        size: any;
+        content?: undefined;
+        files?: undefined;
+        created?: undefined;
+        deleted?: undefined;
+        matches?: undefined;
+        count?: undefined;
+    } | {
+        success: boolean;
+        deleted: boolean;
+        path: string;
+        content?: undefined;
+        files?: undefined;
+        created?: undefined;
+        size?: undefined;
+        updated?: undefined;
         matches?: undefined;
         count?: undefined;
     } | {
@@ -26,5 +67,9 @@ export declare class GitFilesTool implements Tool {
         path?: undefined;
         content?: undefined;
         files?: undefined;
+        created?: undefined;
+        size?: undefined;
+        updated?: undefined;
+        deleted?: undefined;
     }>;
 }

package/dist/tools/gitFiles.js

@@ -21,9 +21,86 @@ export class GitFilesTool {
             const files = await fs.readdir(dirPath);
             return { success: true, files };
         }
-        // Blocked operations
-        if (['create', 'update', 'delete'].includes(action)) {
-            throw new MCPError('OPERATION_RESTRICTED', 'File modification operations are blocked via MCP.');
+        // File modification operations with security validations
+        if (action === 'create') {
+            const filePath = params.filePath;
+            const content = params.content || '';
+            if (!filePath)
+                throw new MCPError('VALIDATION_ERROR', 'filePath is required');
+            // Security: ensure file is within projectPath
+            const targetPath = path.resolve(projectPath, filePath);
+            if (!targetPath.startsWith(path.resolve(projectPath))) {
+                throw new MCPError('SECURITY_ERROR', 'File path must be within project directory');
+            }
+            try {
+                // Create directory if needed
+                const dir = path.dirname(targetPath);
+                await fs.mkdir(dir, { recursive: true });
+                await fs.writeFile(targetPath, content, 'utf-8');
+                return {
+                    success: true,
+                    created: true,
+                    path: targetPath,
+                    size: content.length,
+                };
+            }
+            catch (error) {
+                throw new MCPError('FILE_ERROR', `Failed to create file: ${error.message}`);
+            }
+        }
+        if (action === 'update') {
+            const filePath = params.filePath;
+            const content = params.content;
+            if (!filePath)
+                throw new MCPError('VALIDATION_ERROR', 'filePath is required');
+            if (content === undefined)
+                throw new MCPError('VALIDATION_ERROR', 'content is required');
+            // Security: ensure file is within projectPath
+            const targetPath = path.resolve(projectPath, filePath);
+            if (!targetPath.startsWith(path.resolve(projectPath))) {
+                throw new MCPError('SECURITY_ERROR', 'File path must be within project directory');
+            }
+            try {
+                // Check if file exists
+                await fs.access(targetPath);
+                await fs.writeFile(targetPath, content, 'utf-8');
+                return {
+                    success: true,
+                    updated: true,
+                    path: targetPath,
+                    size: content.length,
+                };
+            }
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    throw new MCPError('FILE_NOT_FOUND', 'File does not exist. Use create action.');
+                }
+                throw new MCPError('FILE_ERROR', `Failed to update file: ${error.message}`);
+            }
+        }
+        if (action === 'delete') {
+            const filePath = params.filePath;
+            if (!filePath)
+                throw new MCPError('VALIDATION_ERROR', 'filePath is required');
+            // Security: ensure file is within projectPath
+            const targetPath = path.resolve(projectPath, filePath);
+            if (!targetPath.startsWith(path.resolve(projectPath))) {
+                throw new MCPError('SECURITY_ERROR', 'File path must be within project directory');
+            }
+            try {
+                await fs.unlink(targetPath);
+                return {
+                    success: true,
+                    deleted: true,
+                    path: targetPath,
+                };
+            }
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    throw new MCPError('FILE_NOT_FOUND', 'File does not exist');
+                }
+                throw new MCPError('FILE_ERROR', `Failed to delete file: ${error.message}`);
+            }
         }
         if (action === 'search') {
             // Simple string search within files in projectPath (non-recursive)

package/dist/tools/gitIssues.js

@@ -1,11 +1,12 @@
 import { MCPError } from '../utils/errors.js';
-import { getRepoInfo } from '../utils/repoHelpers.js';
+import { getRepoInfo, normalizeToolParams } from '../utils/repoHelpers.js';
 export class GitIssuesTool {
     constructor() {
         this.name = 'git-issues';
         this.description = 'Issue management for GitHub and Gitea - automatic dual-provider execution';
     }
     async handle(params, ctx) {
+        params = normalizeToolParams(params);
         const action = params.action;
         if (!action)
             throw new MCPError('VALIDATION_ERROR', 'action is required');

package/dist/tools/gitPackages.js

@@ -1,12 +1,14 @@
 import fs from 'fs/promises';
 import path from 'path';
 import { MCPError } from '../utils/errors.js';
+import { normalizeToolParams } from '../utils/repoHelpers.js';
 export class GitPackagesTool {
     constructor() {
         this.name = 'git-packages';
         this.description = 'Package management operations';
     }
     async handle(params, ctx) {
+        params = normalizeToolParams(params);
         const action = params.action;
         const projectPath = params.projectPath;
         if (!action)

package/dist/tools/gitPulls.js

@@ -1,11 +1,13 @@
 import { MCPError } from '../utils/errors.js';
 import axios from 'axios';
+import { normalizeToolParams } from '../utils/repoHelpers.js';
 export class GitPullsTool {
     constructor() {
         this.name = 'git-pulls';
         this.description = 'Pull request management for GitHub and Gitea - automatic dual-provider execution';
     }
     async handle(params, ctx) {
+        params = normalizeToolParams(params);
         const action = params.action;
         if (!action)
             throw new MCPError('VALIDATION_ERROR', 'action is required');

package/dist/tools/gitRelease.js

@@ -1,5 +1,6 @@
 import simpleGit from 'simple-git';
 import { MCPError } from '../utils/errors.js';
+import { normalizeToolParams } from '../utils/repoHelpers.js';
 import axios from 'axios';
 export class GitReleaseTool {
     constructor() {
@@ -7,6 +8,7 @@ export class GitReleaseTool {
         this.description = 'Release management operations - automatic dual-provider execution';
     }
     async handle(params, ctx) {
+        params = normalizeToolParams(params);
         const action = params.action;
         const projectPath = params.projectPath;
         if (!action)

package/dist/tools/gitWorkflow.js

@@ -1,5 +1,6 @@
 import simpleGit from 'simple-git';
 import { MCPError } from '../utils/errors.js';
+import { normalizeToolParams } from '../utils/repoHelpers.js';
 import axios from 'axios';
 export class GitWorkflowTool {
     constructor() {
@@ -7,9 +8,11 @@ export class GitWorkflowTool {
         this.description = 'Core Git operations including init, status, commit, sync, backup, and remote operations - automatic dual-provider for remote ops';
     }
     async handle(params, ctx) {
+        // Normalize parameters to handle different IDE/agent formats
+        params = normalizeToolParams(params);
         const action = params.action;
         if (!action)
-            throw new MCPError('VALIDATION_ERROR', 'action is required');
+            throw new MCPError('VALIDATION_ERROR', 'action is required. You can use either "action" or "command" parameter.');
         const projectPath = params.projectPath;
         const git = projectPath ? simpleGit({ baseDir: projectPath }) : null;
         switch (action) {

package/dist/utils/repoHelpers.d.ts

@@ -36,3 +36,9 @@ export declare function getRepoInfo(projectPath: string): {
     githubUrl: string | undefined;
     giteaUrl: string | undefined;
 };
+/**
+ * Normalize parameters from different IDEs/agents
+ * Maps common Git commands to tool actions
+ * Handles both 'action' and 'command' parameters
+ */
+export declare function normalizeToolParams(params: Record<string, any>): Record<string, any>;

package/dist/utils/repoHelpers.js

@@ -67,3 +67,56 @@ export function getRepoInfo(projectPath) {
         giteaUrl: giteaOwner ? buildGiteaUrl(giteaOwner, repoName) : undefined,
     };
 }
+/**
+ * Normalize parameters from different IDEs/agents
+ * Maps common Git commands to tool actions
+ * Handles both 'action' and 'command' parameters
+ */
+export function normalizeToolParams(params) {
+    const normalized = { ...params };
+    // If 'command' is provided but not 'action', try to map it
+    if (params.command && !params.action) {
+        const command = params.command.toLowerCase().trim();
+        // Map common git commands to actions
+        const commandMap = {
+            // git-workflow commands
+            'git status': 'status',
+            'status': 'status',
+            'git init': 'init',
+            'init': 'init',
+            'git commit': 'commit',
+            'commit': 'commit',
+            'git push': 'push',
+            'push': 'push',
+            'git pull': 'sync',
+            'pull': 'sync',
+            'git sync': 'sync',
+            'sync': 'sync',
+            // git-branches commands
+            'git branch': 'list',
+            'branch': 'list',
+            'branches': 'list',
+            // git-remote commands
+            'git remote': 'list',
+            'remote': 'list',
+            'remotes': 'list',
+            // git-tags commands
+            'git tag': 'list',
+            'tag': 'list',
+            'tags': 'list',
+            // git-stash commands
+            'git stash': 'list',
+            'stash': 'list',
+            // git-config commands
+            'git config': 'get',
+            'config': 'get',
+        };
+        normalized.action = commandMap[command] || command.replace(/^git\s+/, '');
+    }
+    // If still no action, provide sensible defaults based on tool context
+    if (!normalized.action && params.projectPath) {
+        // Default to 'status' for workflow operations
+        normalized.action = 'status';
+    }
+    return normalized;
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@andrebuzeli/git-mcp",
-  "version": "7.3.3",
+  "version": "7.4.0",
   "type": "module",
-  "description": "Professional MCP server for Git operations - STDIO UNIVERSAL: works in ANY IDE (Cursor, VSCode, Claude Desktop). Fully autonomous DUAL execution (GitHub + Gitea APIs) with automatic username detection. All tools execute on BOTH providers simultaneously. No manual parameters needed.",
+  "description": "Professional MCP server for Git operations - STDIO UNIVERSAL: works in ANY IDE (Cursor, VSCode, Claude Desktop, Trae AI, Kiro.dev). Fully autonomous DUAL execution (GitHub + Gitea APIs) with automatic username detection. Smart parameter normalization handles both 'action' and 'command' formats. All tools execute on BOTH providers simultaneously. No manual parameters needed.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {