@andre.buzeli/git-mcp 15.12.5

package/README.md

@@ -0,0 +1,40 @@
+# @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-update: status -> add -> commit -> push (all-in-one)
+- 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

@@ -0,0 +1,29 @@
+{
+  "name": "@andre.buzeli/git-mcp",
+  "version": "15.12.5",
+  "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

@@ -0,0 +1,147 @@
+#!/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-mcp", version: "15.12.4" },
+  { 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 || {};
+    // Progress reporting removed to prevent timeouts/unknown token errors on slow networks
+    // 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();