Git MCP Server

Instructions

Implementation Reference

• src/git-operations.ts:432-469 (handler)

  Primary implementation of the branch_delete tool handler. Validates repository and branch existence, ensures it's not the current branch, executes 'git branch -D <name>', handles errors, manages caching, and returns formatted success message.

  static async branchDelete({ path, name }: BranchOptions, context: GitToolContext): Promise<GitToolResult> {
    const resolvedPath = this.getPath({ path });
    return await this.executeOperation(
      context.operation,
      resolvedPath,
      async () => {
        const { path: repoPath } = PathValidator.validateGitRepo(resolvedPath);
        PathValidator.validateBranchName(name);
        await RepositoryValidator.validateBranchExists(repoPath, name, context.operation);
        
        const currentBranch = await RepositoryValidator.getCurrentBranch(repoPath, context.operation);
        if (currentBranch === name) {
          throw ErrorHandler.handleValidationError(
            new Error(`Cannot delete the currently checked out branch: ${name}`),
            { operation: context.operation, path: repoPath }
          );
        }
        
        const result = await CommandExecutor.executeGitCommand(
          `branch -D ${name}`,
          context.operation,
          repoPath
        );
  
        return {
          content: [{
            type: 'text',
            text: `Branch '${name}' deleted successfully\n${CommandExecutor.formatOutput(result)}`
          }]
        };
      },
      {
        command: 'branch_delete',
        invalidateCache: true, // Invalidate branch cache
        stateType: RepoStateType.BRANCH
      }
    );
  }

• src/tool-handler.ts:264-281 (registration)

  Registers the 'branch_delete' tool with the MCP server, defining its name, description, and input schema (path and name parameters).

  {
    name: 'branch_delete',
    description: 'Delete a branch',
    inputSchema: {
      type: 'object',
      properties: {
        path: {
          type: 'string',
          description: `Path to repository. ${PATH_DESCRIPTION}`,
        },
        name: {
          type: 'string',
          description: 'Branch name',
        },
      },
      required: ['name'],
    },
  },

• src/tool-handler.ts:613-616 (handler)

  Dispatch handler in the tool executor switch statement that validates arguments using isBranchOptions and calls the main GitOperations.branchDelete handler.

  case 'branch_delete': {
    const validArgs = this.validateArguments(operation, args, isBranchOptions);
    return await GitOperations.branchDelete(validArgs, context);
  }

• src/operations/branch/branch-types.ts:38-45 (schema)

  Type definition for BranchDeleteOptions interface used in branch operations (though simplified in tool usage).

  export interface BranchDeleteOptions extends GitOperationOptions {
    /** Name of the branch to delete */
    name: string;
    /** Whether to force delete even if not merged */
    force?: boolean;
    /** Also delete the branch from remotes */
    remote?: boolean;
  }