Git MCP Server

Instructions

Implementation Reference

• src/git-operations.ts:402-430 (handler)

  The primary handler function for 'branch_create' tool. Validates repository and branch name, executes 'git checkout -b' command with flags for force, track, and setUpstream, handles caching invalidation for branch state, and returns formatted success message.

  static async branchCreate({ path, name, force, track, setUpstream }: 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);
        
        const result = await CommandExecutor.executeGitCommand(
          `checkout -b ${name}${force ? ' --force' : ''}${track ? ' --track' : ' --no-track'}${setUpstream ? ' --set-upstream' : ''}`,
          context.operation,
          repoPath
        );
  
        return {
          content: [{
            type: 'text',
            text: `Branch '${name}' created successfully\n${CommandExecutor.formatOutput(result)}`
          }]
        };
      },
      {
        command: 'branch_create',
        invalidateCache: true, // Invalidate branch cache
        stateType: RepoStateType.BRANCH
      }
    );
  }

• src/tool-handler.ts:231-262 (registration)

  MCP tool registration for 'branch_create', defining the tool name, description, input schema with properties for path, name, force, track, setUpstream, and required fields.

  {
    name: 'branch_create',
    description: 'Create a new branch',
    inputSchema: {
      type: 'object',
      properties: {
        path: {
          type: 'string',
          description: `Path to repository. ${PATH_DESCRIPTION}`,
        },
        name: {
          type: 'string',
          description: 'Branch name',
        },
        force: {
          type: 'boolean',
          description: 'Force create branch even if it exists',
          default: false
        },
        track: {
          type: 'boolean',
          description: 'Set up tracking mode',
          default: true
        },
        setUpstream: {
          type: 'boolean',
          description: 'Set upstream for push/pull',
          default: false
        }
      },
      required: ['name'],
    },

• src/tool-handler.ts:608-611 (schema)

  Tool dispatch handler in switch statement that validates arguments using isBranchOptions type guard and calls GitOperations.branchCreate.

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