@andrebuzeli/git-mcp 15.8.4 → 15.8.6

package/README.md

@@ -1,125 +1,39 @@
-# @andrebuzeli/git-mcp
-
-Servidor MCP (Model Context Protocol) para operações Git locais sem git instalado, com sincronização paralela para GitHub e Gitea.
-
-## Melhorias Implementadas (v15.3.0)
-
-### 🔴 Correções Críticas
-- ✅ **Métodos Faltantes**: `getMergeStatus`, `abortMerge`, `resetHardClean` implementados
-- ✅ **Paralelização runBoth**: GitHub e Gitea executados em paralelo (2x mais rápido)
-- ✅ **withRetry Integrado**: Operações remotas com retry automático
-
-### 🔒 Segurança
-- ✅ **Validação de Path**: Prevenção de path traversal e validação rigorosa
-- ✅ **Logging Configurável**: Debug logging controlado por `DEBUG_AGENT_LOG`
-- ✅ **Limite de Comprimento**: Paths limitados a 260 caracteres (MAX_PATH)
-
-### ⚡ Performance
-- ✅ **Timeout Configurável**: `GIT_TIMEOUT_MS` (default: 60s) para operações Git
-- ✅ **Cache de URLs**: URLs de remotes cacheadas por 10 minutos
-- ✅ **Paginação listAllRepos**: Suporta contas com milhares de repositórios
-- ✅ **Rate Limit Handling**: Backoff automático com Retry-After header
-
-### 🧪 Testabilidade & Desenvolvimento
-- ✅ **Dry Run Mode**: Todas as operações suportam simulação
-- ✅ **Testes Unitários**: Suite Jest com 13 testes passando
-- ✅ **Suporte .env File**: Carrega variáveis de `.env` automaticamente
-- ✅ **Métricas/Telemetria**: Opt-in via `ENABLE_METRICS=true`
-
-### 🔧 Novas Funcionalidades
-- ✅ **Git LFS**: Suporte completo (track, pull, push, status)
-- ✅ **Sistema de Hooks**: Pre/post hooks customizáveis
-- ✅ **Consistência Naming**: camelCase em todas as respostas
-
-### 📊 Variáveis de Ambiente
-
-| Variável | Descrição | Default |
-|----------|-----------|---------|
-| `GITHUB_TOKEN` | Token de autenticação GitHub | - |
-| `GITEA_URL` | URL do servidor Gitea | - |
-| `GITEA_TOKEN` | Token de autenticação Gitea | - |
-| `GIT_TIMEOUT_MS` | Timeout para operações Git | 60000 |
-| `DEBUG_AGENT_LOG` | Habilita logging de debug | false |
-| `ENABLE_METRICS` | Habilita métricas | false |
-
-## Status dos Testes
-
-```
-Test Suites: 2 passed, 2 total
-Tests:       13 passed, 13 total
-```
-
-### Configuração Padrão (npx)
-
-```json
-{
-  "mcpServers": {
-    "git-mcp": {
-      "command": "npx",
-      "args": ["-y", "@andrebuzeli/git-mcp@latest"],
-      "env": {
-        "GITEA_URL": "https://seu-gitea",
-        "GITEA_TOKEN": "...",
-        "GITHUB_TOKEN": "..."
-      }
-    }
-  }
-}
-```
-
-## 🐧 SSH Remote / Linux Server
-
-Se você usa **VS Code Remote SSH**, **Cursor SSH** ou similar, o `npx` pode dar timeout em redes lentas. 
-
-### Solução: Instalação Global
-
-**1. No servidor Linux, execute:**
-```bash
-# Instalação rápida
-curl -fsSL https://raw.githubusercontent.com/andrebuzeli/git-mcp/main/install.sh | bash
-
-# Ou manualmente:
-npm install -g @andrebuzeli/git-mcp@latest
-```
-
-**2. Configure a IDE para usar o comando local:**
-```json
-{
-  "mcpServers": {
-    "git-mcp": {
-      "command": "git-mcp",
-      "env": {
-        "GITHUB_TOKEN": "...",
-        "GITEA_URL": "https://seu-gitea",
-        "GITEA_TOKEN": "..."
-      }
-    }
-  }
-}
-```
-
-### Troubleshooting
-
-| Erro | Solução |
-|------|---------|
-| `ETIMEDOUT` / `Request timed out` | Use instalação global ao invés de npx |
-| `command not found: git-mcp` | Verifique se npm global está no PATH |
-| Permissão negada | Use `sudo npm install -g @andrebuzeli/git-mcp` |
-
-## Tools
-
-- git-workflow: init, status, add, remove, commit, ensure-remotes, push
-- git-remote: list, ensure
-- git-branches: list, create, delete, rename, checkout
-- git-tags: list, create, delete, push
-- git-stash: list, save, apply, pop, drop, clear
-- git-reset: soft, mixed, hard
-- git-config: get, set, unset, list
-- git-ignore: list, create, add, remove
-- git-files: list, read
-- git-history: log
-- git-sync: fetch, pull
-- git-issues: create, list, comment
-- git-pulls: create, list, files
-
-Todas as tools exigem `projectPath` e operam com derivação automática do nome do repositório a partir do caminho.
+# @andrebuzeli/git-mcp
+
+Servidor MCP (Model Context Protocol) para operações Git locais sem git instalado, com sincronização paralela para GitHub e Gitea.
+
+## Configuração MCP
+
+```json
+{
+  "mcpServers": {
+    "git-mcp": {
+      "command": "npx",
+      "args": ["@andrebuzeli/git-mcp@latest"],
+      "env": {
+        "GITEA_URL": "https://seu-gitea",
+        "GITEA_TOKEN": "...",
+        "GITHUB_TOKEN": "..."
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+- git-workflow: init, status, add, remove, commit, ensure-remotes, push
+- git-remote: list, ensure
+- git-branches: list, create, delete, rename, checkout
+- git-tags: list, create, delete, push
+- git-stash: list, save, apply, pop, drop, clear
+- git-reset: soft, mixed, hard
+- git-config: get, set, unset, list
+- git-ignore: list, create, add, remove
+- git-files: list, read
+- git-history: log
+- git-sync: fetch, pull
+- git-issues: create, list, comment
+- git-pulls: create, list, files
+
+Todas as tools exigem `projectPath` e operam com derivação automática do nome do repositório a partir do caminho.

package/package.json

@@ -1,45 +1,29 @@
-{
-  "name": "@andrebuzeli/git-mcp",
-  "version": "15.8.4",
-  "private": false,
-  "description": "MCP server para Git com operações locais e sincronização paralela GitHub/Gitea",
-  "license": "MIT",
-  "author": "andrebuzeli",
-  "type": "module",
-  "publishConfig": {
-    "access": "public"
-  },
-  "files": [
-    "src",
-    "README.md",
-    "install.sh"
-  ],
-  "main": "src/index.js",
-  "bin": {
-    "git-mcp": "src/index.js",
-    "git-mcpv2": "src/index.js"
-  },
-  "scripts": {
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
-    "test:comprehensive": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.comprehensive.config.js",
-    "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.comprehensive.config.js --coverage",
-    "test:utils": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.comprehensive.config.js test/comprehensive/test-utils.js",
-    "test:gitadapter": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.comprehensive.config.js test/comprehensive/test-gitadapter.js",
-    "test:providers": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.comprehensive.config.js test/comprehensive/test-provider-manager.js",
-    "test:tools": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.comprehensive.config.js test/comprehensive/test-tools.js",
-    "test:resources": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.comprehensive.config.js test/comprehensive/test-resources.js",
-    "test:integration": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.comprehensive.config.js test/comprehensive/test-integration.js",
-    "test:security": "node --experimental-vm-modules node_modules/jest/bin/jest.js --config jest.comprehensive.config.js test/comprehensive/test-security.js"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.4.0",
-    "@octokit/rest": "^20.0.0",
-    "ajv": "^8.12.0",
-    "archiver": "^7.0.1",
-    "axios": "^1.7.7"
-  },
-  "devDependencies": {
-    "jest": "^30.2.0"
-  }
+{
+  "name": "@andrebuzeli/git-mcp",
+  "version": "15.8.6",
+  "private": false,
+  "description": "MCP server para Git com operações locais e sincronização paralela GitHub/Gitea",
+  "license": "MIT",
+  "author": "andrebuzeli",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "main": "src/index.js",
+  "bin": {
+    "git-mcp": "src/index.js",
+    "git-mcpv2": "src/index.js"
+  },
+  "scripts": {},
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.4.0",
+    "@octokit/rest": "^20.0.0",
+    "ajv": "^8.12.0",
+    "archiver": "^7.0.0",
+    "axios": "^1.7.7"
+  }
 }

package/src/index.js

@@ -1,139 +1,146 @@
-#!/usr/bin/env node
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import Ajv from "ajv";
-import { loadEnv } from "./utils/env.js";
-import { asToolError } from "./utils/errors.js";
-import { ProviderManager } from "./providers/providerManager.js";
-import { GitAdapter } from "./utils/gitAdapter.js";
-import { createGitWorkflowTool } from "./tools/git-workflow.js";
-import { createGitRemoteTool } from "./tools/git-remote.js";
-import { createGitBranchesTool } from "./tools/git-branches.js";
-import { createGitTagsTool } from "./tools/git-tags.js";
-import { createGitStashTool } from "./tools/git-stash.js";
-import { createGitResetTool } from "./tools/git-reset.js";
-import { createGitConfigTool } from "./tools/git-config.js";
-import { createGitIgnoreTool } from "./tools/git-ignore.js";
-import { createGitFilesTool } from "./tools/git-files.js";
-import { createGitHistoryTool } from "./tools/git-history.js";
-import { createGitSyncTool } from "./tools/git-sync.js";
-import { createGitIssuesTool } from "./tools/git-issues.js";
-import { createGitPullsTool } from "./tools/git-pulls.js";
-import { createGitMergeTool } from "./tools/git-merge.js";
-import { createGitDiffTool } from "./tools/git-diff.js";
-import { createGitCloneTool } from "./tools/git-clone.js";
-import { createGitHelpTool } from "./tools/git-help.js";
-import { getResources, readResource } from "./resources/index.js";
-import { createPromptsHandler, PROMPTS } from "./prompts/index.js";
-
-// Carrega variáveis de ambiente do arquivo .env (se existir)
-loadEnv();
-
-const pm = new ProviderManager();
-const git = new GitAdapter(pm);
-
-// Log de inicialização para stderr (não interfere com stdio do MCP)
-const hasGitHub = !!process.env.GITHUB_TOKEN;
-const hasGitea = !!process.env.GITEA_URL && !!process.env.GITEA_TOKEN;
-if (!hasGitHub && !hasGitea) {
-  console.error("[git-mcp] ⚠️ Nenhum provider configurado. Operações remotas não funcionarão.");
-  console.error("[git-mcp] Configure GITHUB_TOKEN e/ou GITEA_URL + GITEA_TOKEN");
-} else {
-  const providers = [];
-  if (hasGitHub) providers.push("GitHub");
-  if (hasGitea) providers.push("Gitea");
-  console.error(`[git-mcp] ✓ Providers ativos: ${providers.join(", ")}`);
-}
-
-const transport = new StdioServerTransport();
-const server = new Server(
-  { name: "git-mcpv2", version: "15.8.0" },
-  { capabilities: { tools: {}, resources: {}, prompts: {} } }
-);
-server.connect(transport);
-
-// Prompts handler
-const promptsHandler = createPromptsHandler(git, pm);
-
-// Ajv singleton para validação
-const ajv = new Ajv({ allErrors: true });
-
-const tools = [
-  createGitHelpTool(),  // Primeiro: AI pode pedir ajuda
-  createGitWorkflowTool(pm, git),
-  createGitRemoteTool(pm, git),
-  createGitBranchesTool(git),
-  createGitTagsTool(git),
-  createGitStashTool(git),
-  createGitResetTool(git),
-  createGitConfigTool(git),
-  createGitIgnoreTool(git),
-  createGitFilesTool(git),
-  createGitHistoryTool(git),
-  createGitSyncTool(git),
-  createGitIssuesTool(pm),
-  createGitPullsTool(pm),
-  createGitMergeTool(git),
-  createGitDiffTool(git),
-  createGitCloneTool(git),
-];
-
-// ============ TOOLS ============
-server.setRequestHandler(
-  (await import("@modelcontextprotocol/sdk/types.js")).ListToolsRequestSchema,
-  async () => ({
-    tools: tools.map(t => ({ name: t.name, description: t.description, inputSchema: t.inputSchema })),
-  })
-);
-
-server.setRequestHandler(
-  (await import("@modelcontextprotocol/sdk/types.js")).CallToolRequestSchema,
-  async (req) => {
-    const name = req.params?.name || "";
-    const args = req.params?.arguments || {};
-    const tool = tools.find(t => t.name === name);
-    if (!tool) return { content: [{ type: "text", text: `Tool não encontrada: ${name}` }], isError: true };
-    try {
-      const result = await tool.handle(args);
-      return result;
-    } catch (e) {
-      return asToolError(e.code || "ERROR", e.message || String(e));
-    }
-  }
-);
-
-// ============ RESOURCES ============
-server.setRequestHandler(
-  (await import("@modelcontextprotocol/sdk/types.js")).ListResourcesRequestSchema,
-  async () => ({ resources: getResources() })
-);
-
-server.setRequestHandler(
-  (await import("@modelcontextprotocol/sdk/types.js")).ReadResourceRequestSchema,
-  async (req) => {
-    const uri = req.params?.uri || "";
-    const content = readResource(uri);
-    if (!content) {
-      return { contents: [{ uri, mimeType: "text/plain", text: `Resource não encontrado: ${uri}` }] };
-    }
-    return { contents: [{ uri, mimeType: "text/markdown", text: content }] };
-  }
-);
-
-// ============ PROMPTS ============
-server.setRequestHandler(
-  (await import("@modelcontextprotocol/sdk/types.js")).ListPromptsRequestSchema,
-  async () => ({ prompts: PROMPTS })
-);
-
-server.setRequestHandler(
-  (await import("@modelcontextprotocol/sdk/types.js")).GetPromptRequestSchema,
-  async (req) => {
-    const name = req.params?.name || "";
-    const args = req.params?.arguments || {};
-    return await promptsHandler.get(name, args);
-  }
-);
-
-// Keep process alive
-process.stdin.resume();
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import Ajv from "ajv";
+import { loadEnv } from "./utils/env.js";
+import { asToolError } from "./utils/errors.js";
+import { ProviderManager } from "./providers/providerManager.js";
+import { GitAdapter } from "./utils/gitAdapter.js";
+import { createGitWorkflowTool } from "./tools/git-workflow.js";
+import { createGitRemoteTool } from "./tools/git-remote.js";
+import { createGitBranchesTool } from "./tools/git-branches.js";
+import { createGitTagsTool } from "./tools/git-tags.js";
+import { createGitStashTool } from "./tools/git-stash.js";
+import { createGitResetTool } from "./tools/git-reset.js";
+import { createGitConfigTool } from "./tools/git-config.js";
+import { createGitIgnoreTool } from "./tools/git-ignore.js";
+import { createGitFilesTool } from "./tools/git-files.js";
+import { createGitHistoryTool } from "./tools/git-history.js";
+import { createGitSyncTool } from "./tools/git-sync.js";
+import { createGitIssuesTool } from "./tools/git-issues.js";
+import { createGitPullsTool } from "./tools/git-pulls.js";
+import { createGitMergeTool } from "./tools/git-merge.js";
+import { createGitDiffTool } from "./tools/git-diff.js";
+import { createGitCloneTool } from "./tools/git-clone.js";
+import { createGitHelpTool } from "./tools/git-help.js";
+import { getResources, readResource } from "./resources/index.js";
+import { createPromptsHandler, PROMPTS } from "./prompts/index.js";
+
+// Carrega variáveis de ambiente do arquivo .env (se existir)
+loadEnv();
+
+const pm = new ProviderManager();
+const git = new GitAdapter(pm);
+
+// Log de inicialização para stderr (não interfere com stdio do MCP)
+const hasGitHub = !!process.env.GITHUB_TOKEN;
+const hasGitea = !!process.env.GITEA_URL && !!process.env.GITEA_TOKEN;
+if (!hasGitHub && !hasGitea) {
+  console.error("[git-mcp] ⚠️ Nenhum provider configurado. Operações remotas não funcionarão.");
+  console.error("[git-mcp] Configure GITHUB_TOKEN e/ou GITEA_URL + GITEA_TOKEN");
+} else {
+  const providers = [];
+  if (hasGitHub) providers.push("GitHub");
+  if (hasGitea) providers.push("Gitea");
+  console.error(`[git-mcp] ✓ Providers ativos: ${providers.join(", ")}`);
+}
+
+const transport = new StdioServerTransport();
+const server = new Server(
+  { name: "git-mcpv2", version: "15.8.0" },
+  { capabilities: { tools: {}, resources: {}, prompts: {} } }
+);
+server.connect(transport);
+
+// Prompts handler
+const promptsHandler = createPromptsHandler(git, pm);
+
+// Ajv singleton para validação
+const ajv = new Ajv({ allErrors: true });
+
+const tools = [
+  createGitHelpTool(),  // Primeiro: AI pode pedir ajuda
+  createGitWorkflowTool(pm, git),
+  createGitRemoteTool(pm, git),
+  createGitBranchesTool(git),
+  createGitTagsTool(git),
+  createGitStashTool(git),
+  createGitResetTool(git),
+  createGitConfigTool(git),
+  createGitIgnoreTool(git),
+  createGitFilesTool(git),
+  createGitHistoryTool(git),
+  createGitSyncTool(git),
+  createGitIssuesTool(pm),
+  createGitPullsTool(pm),
+  createGitMergeTool(git),
+  createGitDiffTool(git),
+  createGitCloneTool(git),
+];
+
+// ============ TOOLS ============
+server.setRequestHandler(
+  (await import("@modelcontextprotocol/sdk/types.js")).ListToolsRequestSchema,
+  async () => ({
+    tools: tools.map(t => ({ name: t.name, description: t.description, inputSchema: t.inputSchema })),
+  })
+);
+
+server.setRequestHandler(
+  (await import("@modelcontextprotocol/sdk/types.js")).CallToolRequestSchema,
+  async (req) => {
+    const name = req.params?.name || "";
+    const args = req.params?.arguments || {};
+    const progressToken = req.params?._meta?.progressToken;
+    const tool = tools.find(t => t.name === name);
+    if (!tool) return { content: [{ type: "text", text: `Tool não encontrada: ${name}` }], isError: true };
+    try {
+      if (progressToken) {
+        await server.notification({ method: "notifications/progress", params: { progressToken, progress: 0 } });
+      }
+      const result = await tool.handle(args);
+      if (progressToken) {
+        await server.notification({ method: "notifications/progress", params: { progressToken, progress: 100 } });
+      }
+      return result;
+    } catch (e) {
+      return asToolError(e.code || "ERROR", e.message || String(e));
+    }
+  }
+);
+
+// ============ RESOURCES ============
+server.setRequestHandler(
+  (await import("@modelcontextprotocol/sdk/types.js")).ListResourcesRequestSchema,
+  async () => ({ resources: getResources() })
+);
+
+server.setRequestHandler(
+  (await import("@modelcontextprotocol/sdk/types.js")).ReadResourceRequestSchema,
+  async (req) => {
+    const uri = req.params?.uri || "";
+    const content = readResource(uri);
+    if (!content) {
+      return { contents: [{ uri, mimeType: "text/plain", text: `Resource não encontrado: ${uri}` }] };
+    }
+    return { contents: [{ uri, mimeType: "text/markdown", text: content }] };
+  }
+);
+
+// ============ PROMPTS ============
+server.setRequestHandler(
+  (await import("@modelcontextprotocol/sdk/types.js")).ListPromptsRequestSchema,
+  async () => ({ prompts: PROMPTS })
+);
+
+server.setRequestHandler(
+  (await import("@modelcontextprotocol/sdk/types.js")).GetPromptRequestSchema,
+  async (req) => {
+    const name = req.params?.name || "";
+    const args = req.params?.arguments || {};
+    return await promptsHandler.get(name, args);
+  }
+);
+
+// Keep process alive
+process.stdin.resume();