@andre.buzeli/git-mcp 16.0.8 → 16.1.2

package/src/tools/git-history.js

@@ -10,7 +10,7 @@ export function createGitHistoryTool(git) {
     properties: {
       projectPath: { 
         type: "string",
-        description: "Caminho absoluto do diretório do projeto"
+        description: "Caminho absoluto do diretório do projeto no IDE (ex: '/home/user/meu-projeto' ou 'C:/Users/user/meu-projeto'). IMPORTANTE: este valor não pode ser inferido automaticamente pelo servidor — o agente deve fornecer o path real do projeto sendo trabalhado, não o diretório home do usuário."
       },
       action: { 
         type: "string", 
@@ -30,7 +30,11 @@ export function createGitHistoryTool(git) {
     additionalProperties: false
   };
 
-  const description = `Histórico de commits do repositório Git.
+  const description = `IMPORTANTE — projectPath:
+Informe o caminho absoluto do projeto aberto no IDE. O servidor MCP não tem acesso ao
+contexto do IDE e não consegue detectar automaticamente qual projeto está sendo trabalhado.
+
+Histórico de commits do repositório Git.
 
 QUANDO USAR:
 - Ver commits recentes
@@ -86,5 +90,11 @@ EXEMPLOS:
     }
   }
 
-  return { name: "git-history", description, inputSchema, handle };
+  return { 
+    name: "git-history", 
+    description, 
+    inputSchema, 
+    handle,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
+  };
 }

package/src/tools/git-ignore.js

@@ -11,7 +11,7 @@ export function createGitIgnoreTool(git) {
     properties: {
       projectPath: {
         type: "string",
-        description: "Caminho absoluto do diretório do projeto"
+        description: "Caminho absoluto do diretório do projeto no IDE (ex: '/home/user/meu-projeto' ou 'C:/Users/user/meu-projeto'). IMPORTANTE: este valor não pode ser inferido automaticamente pelo servidor — o agente deve fornecer o path real do projeto sendo trabalhado, não o diretório home do usuário."
       },
       action: {
         type: "string",
@@ -32,7 +32,11 @@ export function createGitIgnoreTool(git) {
     additionalProperties: false
   };
 
-  const description = `Gerenciamento do arquivo .gitignore.
+  const description = `IMPORTANTE — projectPath:
+Informe o caminho absoluto do projeto aberto no IDE. O servidor MCP não tem acesso ao
+contexto do IDE e não consegue detectar automaticamente qual projeto está sendo trabalhado.
+
+Gerenciamento do arquivo .gitignore.
 
 PADRÕES COMUNS:
 - node_modules/: Dependências Node.js
@@ -95,5 +99,11 @@ EXEMPLOS:
     }
   }
 
-  return { name: "git-ignore", description, inputSchema, handle };
+  return { 
+    name: "git-ignore", 
+    description, 
+    inputSchema, 
+    handle,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
+  };
 }

package/src/tools/git-issues.js

@@ -12,7 +12,7 @@ export function createGitIssuesTool(pm) {
     properties: {
       projectPath: {
         type: "string",
-        description: "Caminho absoluto do diretório do projeto"
+        description: "Caminho absoluto do diretório do projeto no IDE (ex: '/home/user/meu-projeto' ou 'C:/Users/user/meu-projeto'). IMPORTANTE: este valor não pode ser inferido automaticamente pelo servidor — o agente deve fornecer o path real do projeto sendo trabalhado, não o diretório home do usuário."
       },
       action: {
         type: "string",
@@ -43,7 +43,11 @@ export function createGitIssuesTool(pm) {
     additionalProperties: false
   };
 
-  const description = `Gerenciamento de Issues no GitHub e Gitea.
+  const description = `IMPORTANTE — projectPath:
+Informe o caminho absoluto do projeto aberto no IDE. O servidor MCP não tem acesso ao
+contexto do IDE e não consegue detectar automaticamente qual projeto está sendo trabalhado.
+
+Gerenciamento de Issues no GitHub e Gitea.
 
 QUANDO USAR:
 - Reportar bugs encontrados
@@ -97,5 +101,11 @@ BOAS PRÁTICAS:
     }
   }
 
-  return { name: "git-issues", description, inputSchema, handle };
+  return { 
+    name: "git-issues", 
+    description, 
+    inputSchema, 
+    handle,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
+  };
 }

package/src/tools/git-merge.js

@@ -10,7 +10,7 @@ export function createGitMergeTool(git) {
     properties: {
       projectPath: { 
         type: "string",
-        description: "Caminho absoluto do diretório do projeto"
+        description: "Caminho absoluto do diretório do projeto no IDE (ex: '/home/user/meu-projeto' ou 'C:/Users/user/meu-projeto'). IMPORTANTE: este valor não pode ser inferido automaticamente pelo servidor — o agente deve fornecer o path real do projeto sendo trabalhado, não o diretório home do usuário."
       },
       action: { 
         type: "string", 
@@ -41,7 +41,11 @@ export function createGitMergeTool(git) {
     additionalProperties: false
   };
 
-  const description = `Merge de branches Git.
+  const description = `IMPORTANTE — projectPath:
+Informe o caminho absoluto do projeto aberto no IDE. O servidor MCP não tem acesso ao
+contexto do IDE e não consegue detectar automaticamente qual projeto está sendo trabalhado.
+
+Merge de branches Git.
 
 QUANDO USAR:
 - Integrar mudanças de uma feature branch na main
@@ -148,5 +152,11 @@ SQUASH:
     }
   }
 
-  return { name: "git-merge", description, inputSchema, handle };
+  return { 
+    name: "git-merge", 
+    description, 
+    inputSchema, 
+    handle,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
+  };
 }

package/src/tools/git-pulls.js

@@ -1,7 +1,7 @@
 import Ajv from "ajv";
 import axios from "axios";
 import { asToolError, asToolResult, errorToResponse } from "../utils/errors.js";
-import { getRepoNameFromPath, validateProjectPath } from "../utils/repoHelpers.js";
+import { getRepoNameFromPath, validateProjectPath, withRetry } from "../utils/repoHelpers.js";
 import { runBoth } from "../utils/providerExec.js";
 
 const ajv = new Ajv({ allErrors: true });
@@ -12,7 +12,7 @@ export function createGitPullsTool(pm) {
     properties: {
       projectPath: {
         type: "string",
-        description: "Caminho absoluto do diretório do projeto"
+        description: "Caminho absoluto do diretório do projeto no IDE (ex: '/home/user/meu-projeto' ou 'C:/Users/user/meu-projeto'). IMPORTANTE: este valor não pode ser inferido automaticamente pelo servidor — o agente deve fornecer o path real do projeto sendo trabalhado, não o diretório home do usuário."
       },
       action: {
         type: "string",
@@ -51,7 +51,11 @@ export function createGitPullsTool(pm) {
     additionalProperties: false
   };
 
-  const description = `Gerenciamento de Pull Requests no GitHub e Gitea.
+  const description = `IMPORTANTE — projectPath:
+Informe o caminho absoluto do projeto aberto no IDE. O servidor MCP não tem acesso ao
+contexto do IDE e não consegue detectar automaticamente qual projeto está sendo trabalhado.
+
+Gerenciamento de Pull Requests no GitHub e Gitea.
 
 QUANDO USAR:
 - Propor mudanças de uma branch para outra
@@ -111,5 +115,11 @@ NOTA: O PR é criado em AMBOS os providers simultaneamente.`;
     }
   }
 
-  return { name: "git-pulls", description, inputSchema, handle };
+  return { 
+    name: "git-pulls", 
+    description, 
+    inputSchema, 
+    handle,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
+  };
 }