Git Repo Browser MCP

Instructions

Implementation Reference

• src/handlers/remote-operations.js:11-65 (handler)

  The core handler function that executes the git push operation. It initializes simpleGit in the repo_path, auto-detects the current branch if none specified, pushes to the given remote/branch with optional --force, and returns an MCP-formatted response with success details or error.
  export async function handleGitPush({ repo_path, remote = "origin", branch = null, force = false, }) { try { const git = simpleGit(repo_path); // If no branch specified, get the current branch if (!branch) { const branchInfo = await git.branch(); branch = branchInfo.current; } // Perform the push let pushOptions = []; if (force) { pushOptions.push("--force"); } const pushResult = await git.push(remote, branch, pushOptions); return { content: [ { type: "text", text: JSON.stringify( { success: true, result: pushResult, message: `Pushed ${branch} to ${remote}`, }, null, 2 ), }, ], }; } catch (error) { return { content: [ { type: "text", text: JSON.stringify( { error: `Failed to push changes: ${error.message}` }, null, 2 ), }, ], isError: true, }; } }
• src/server.js:419-446 (schema)

  Defines the input schema and metadata for the 'git_push' tool in the toolsList array, used by ListToolsRequestHandler. Specifies required repo_path and optional remote, branch, force parameters.
  { name: "git_push", description: "Push changes to a remote repository.", inputSchema: { type: "object", properties: { repo_path: { type: "string", description: "The path to the local Git repository", }, remote: { type: "string", description: "Remote name", default: "origin", }, branch: { type: "string", description: "Branch to push (default: current branch)", }, force: { type: "boolean", description: "Whether to force push", default: false, }, }, required: ["repo_path"], }, },
• src/server.js:912-912 (registration)

  Registers 'git_push' tool name to the handleGitPush function in the handlersMap object, enabling fast lookup during CallToolRequest handling.
  git_push: handleGitPush,
• src/server.js:21-24 (registration)

  Imports the handleGitPush handler from handlers/index.js (which re-exports from remote-operations.js) into the server class.
  handleGitDeleteBranch, handleGitMergeBranch, handleGitPush, handleGitPull,
• src/handlers/remote-operations.js:1-1 (helper)

  Imports simpleGit utility from common.js, used throughout the handler for Git operations.
  import { simpleGit } from "./common.js";