@andre.buzeli/git-mcp 16.1.2 → 16.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andre.buzeli/git-mcp",
-  "version": "16.1.2",
+  "version": "16.1.3",
   "private": false,
   "description": "MCP server para Git com operações locais e sincronização paralela GitHub/Gitea",
   "license": "MIT",

package/src/index.js

@@ -49,13 +49,59 @@ if (!hasGitHub && !hasGitea) {
 
 const transport = new StdioServerTransport();
 const server = new Server(
-  { name: "git-mcp", version: "16.0.8" },
-  { capabilities: {
-    tools: { listChanged: true },
-    resources: { subscribe: true, listChanged: true },
-    prompts: {},
-    logging: {}
-  } }
+  { name: "git-mcp", version: "16.1.3" },
+  {
+    capabilities: {
+      tools: { listChanged: true },
+      resources: { subscribe: true, listChanged: true },
+      prompts: {},
+      logging: {}
+    },
+    instructions: `# git-mcp — Instruções para AI Agents
+
+## REGRA #1: projectPath é OBRIGATÓRIO
+Toda tool (exceto git-help) exige "projectPath" com o caminho absoluto do projeto aberto no IDE.
+O servidor NÃO consegue detectar o projeto automaticamente.
+Exemplo: "projectPath": "C:/Users/user/meu-projeto" ou "/home/user/meu-projeto"
+
+## REGRA #2: action é OBRIGATÓRIO
+Toda tool usa o padrão { "projectPath": "...", "action": "nome-da-action", ...params }.
+Consulte o enum de cada tool para saber as actions disponíveis.
+
+## Guia Rápido de Tools
+
+| Necessidade | Tool | Action | Params obrigatórios |
+|-------------|------|--------|---------------------|
+| Atualizar projeto completo | git-workflow | update | message |
+| Ver status do repo | git-workflow | status | - |
+| Inicializar repo novo | git-workflow | init | - |
+| Ver diferenças locais | git-diff | show | - |
+| Comparar branches/commits | git-diff | compare | target |
+| Criar branch | git-branches | create | branch |
+| Trocar branch | git-branches | checkout | branch |
+| Listar branches | git-branches | list | - |
+| Merge de branch | git-merge | merge | sourceBranch |
+| Criar tag | git-tags | create | tag |
+| Clonar repo | git-clone | clone | url |
+| Criar issue | git-issues | create | title |
+| Criar PR | git-pulls | create | head, title |
+| Salvar stash | git-stash | save | - |
+| Reset commits | git-reset | soft/mixed/hard | - |
+| Configurar git | git-config | get/set | key |
+| Gerenciar .gitignore | git-ignore | add/list | patterns |
+| Ler arquivo do git | git-files | read | filepath |
+| Ver histórico | git-history | log | - |
+| Fetch/Pull remoto | git-sync | fetch/pull | - |
+| Gerenciar remotes | git-remote | list/ensure | - |
+
+## Exemplo Completo (ação mais comum)
+\`\`\`json
+{ "projectPath": "/caminho/do/projeto", "action": "update", "message": "feat: descrição das mudanças" }
+\`\`\`
+
+## Dica
+Use git-help action="listTools" para ver todas as tools e actions disponíveis em tempo real.`
+  }
 );
 server.connect(transport);
 

package/src/resources/index.js

@@ -69,9 +69,9 @@ Visualizar diferenças.
 
 | Action | Descrição | Parâmetros |
 |--------|-----------|------------|
-| show | Ver mudanças locais | filepath="src/file.js" (opcional) |
-| compare | Comparar commits | fromRef="HEAD~1", toRef="HEAD" |
-| stat | Estatísticas | fromRef="HEAD~1", toRef="HEAD" |
+| show | Ver mudanças locais (working vs HEAD) | staged=true (opcional, para staged vs HEAD) |
+| compare | Comparar branches/commits | target="main" (obrigatório), source="HEAD" (opcional) |
+| stat | Estatísticas resumidas | target="HEAD~1" (opcional), source (opcional) |
 
 ---
 

package/src/tools/git-diff.js

@@ -30,6 +30,7 @@ export function createGitDiffTool(git) {
       },
       staged: {
         type: "boolean",
+        default: false,
         description: "Para action='show': comparar staged vs HEAD (em vez de working vs index). Default: false"
       }
     },

package/src/tools/git-history.js

@@ -19,10 +19,12 @@ export function createGitHistoryTool(git) {
       },
       ref: { 
         type: "string",
+        default: "HEAD",
         description: "Referência inicial para o log (branch, tag, SHA). Default: HEAD"
       },
       maxCount: { 
         type: "number",
+        default: 50,
         description: "Número máximo de commits a retornar. Default: 50"
       }
     },

package/src/tools/git-stash.js

@@ -34,6 +34,7 @@ export function createGitStashTool(git) {
       },
       includeUntracked: {
         type: "boolean",
+        default: false,
         description: "Incluir arquivos não rastreados no stash (action='save'). Default: false"
       }
     },

package/src/tools/git-workflow.js

@@ -40,7 +40,8 @@ export function createGitWorkflowTool(pm, git, server) {
       files: {
         type: "array",
         items: { type: "string" },
-        description: "Lista de arquivos para add/remove. Use ['.'] para todos os arquivos. Ex: ['src/index.js', 'package.json']"
+        default: ["."],
+        description: "Lista de arquivos para add/remove. Default: ['.'] (todos). Ex: ['src/index.js', 'package.json']"
       },
       message: {
         type: "string",
@@ -61,22 +62,27 @@ export function createGitWorkflowTool(pm, git, server) {
       },
       force: {
         type: "boolean",
+        default: false,
         description: "Force push (use apenas se push normal falhar com erro de histórico divergente). Default: false"
       },
       createGitignore: {
         type: "boolean",
+        default: true,
         description: "Se true, cria .gitignore padrão baseado no tipo de projeto (action='init'). Default: true"
       },
       isPublic: {
         type: "boolean",
+        default: false,
         description: "Se true, repositório será PÚBLICO. Default: false (privado). Aplica-se a action='init' e 'ensure-remotes'"
       },
       dryRun: {
         type: "boolean",
+        default: false,
         description: "Se true, simula a operação sem executar (útil para testes). Default: false"
       },
       skipIfClean: {
         type: "boolean",
+        default: false,
         description: "Para action='update': se true, pula silenciosamente se não houver mudanças. Default: false"
       },
       gitignore: {