@andrebuzeli/git-mcp 7.0.2 → 7.0.3

package/dist/resources/toolsGuide.js

@@ -10,11 +10,33 @@ 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 v7.0.0 - Complete Tools Guide
+    content: `# 🛠️ Git-MCP v7.0.2 - Complete Tools Guide
 
 > **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.2:** Central projectPath validation - ALL tools require projectPath (no exceptions)
+
+---
+
+## 🚨 CRITICAL: projectPath is MANDATORY for ALL TOOLS
+
+**EVERY SINGLE TOOL CALL REQUIRES projectPath AS THE FIRST PARAMETER**
+
+### Why projectPath is Required:
+- ✅ It's where the .git folder is located
+- ✅ ALL Git commands run in this directory
+- ✅ Local AND remote operations use this context
+- ✅ It MUST be the absolute path to project ROOT
+- ✅ The server validates this BEFORE calling any tool
+
+### Validation:
+If you call ANY tool without projectPath, you will get:
+\\\`\\\`\\\`json
+{
+  "errorCode": "VALIDATION_ERROR",
+  "message": "projectPath is required for all tool calls"
+}
+\\\`\\\`\\\`
 
 ---
 
@@ -23,7 +45,7 @@ exports.TOOLS_GUIDE = {
 **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: {...} }\`
+- ✅ Return separated responses: { github: {...}, gitea: {...} }
 - ✅ NO manual owner/user/author parameters needed
 - ✅ Each provider uses its own credentials automatically
 
@@ -38,21 +60,27 @@ GITEA_URL=http://your-gitea-server:port
 
 ---
 
-## ⚠️ CRITICAL: projectPath Requirements
+## ⚠️ projectPath Requirements (MANDATORY - NO EXCEPTIONS)
 
-**ALL TOOLS REQUIRE projectPath PARAMETER**
+**RULE: projectPath MUST be provided in EVERY tool call**
 
 ### ✅ Correct Usage:
 \\\`\\\`\\\`javascript
 {
-  "projectPath": "Z:/absolute/path/to/project-root"
-  // Must be the ROOT folder of the opened project
+  "projectPath": "Z:/absolute/path/to/project-root",  // ← MANDATORY FIRST PARAMETER
+  "action": "stats"
+  // projectPath must be absolute path to project ROOT folder
   // NOT a subfolder, NOT a file, NOT a parent folder
 }
 \\\`\\\`\\\`
 
 ### ❌ WRONG Usage:
 \\\`\\\`\\\`javascript
+// ❌ Missing projectPath (will be rejected by server)
+{
+  "action": "stats"
+}
+
 // ❌ Relative path
 "projectPath": "./my-project"
 
@@ -66,10 +94,13 @@ GITEA_URL=http://your-gitea-server:port
 "projectPath": "/project/package.json"
 \\\`\\\`\\\`
 
-### 📋 Rule:
+### 📋 Rules:
 **projectPath MUST be:**
+- ✅ **MANDATORY** - Cannot be omitted (server will reject)
 - ✅ Absolute path (starts with / or drive letter)
 - ✅ Points to the ROOT folder of the opened project
+- ✅ Where the .git folder is located
+- ✅ The working directory for ALL Git operations
 - ✅ The same folder you opened in your IDE
 - ✅ Contains .git folder (for Git operations)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrebuzeli/git-mcp",
-  "version": "7.0.2",
+  "version": "7.0.3",
   "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.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",