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";