git_create_branch

Create a new branch in a Git repository, optionally specifying a base branch to start from, using the MCP Git Server's branch management tool.

Instructions

Creates a new branch from an optional base branch

Input Schema

TableJSON Schema

Name	Required	Description	Default
`base_branch`	No
`branch_name`	Yes
`repo_path`	Yes

Implementation Reference

src/mcp_server_git/git/operations.py:751-786 (handler)

Core handler function that implements the git_create_branch tool logic using GitPython Repo.create_head() to create a new branch from an optional base branch, with existence checks and error handling.

def git_create_branch(
    repo: Repo,
    branch_name: str,
    base_branch: str | None = None,
    start_point: str | None = None,
) -> str:
    """Create new branch from base - UPDATED VERSION 2024"""
    try:
        # INTEGRATED DEBUG LOGGING
        # Use start_point if provided, otherwise fall back to base_branch
        effective_base = start_point if start_point is not None else base_branch

        # Check if branch already exists
        existing_branches = [branch.name for branch in repo.branches]
        if branch_name in existing_branches:
            return f"❌ Branch '{branch_name}' already exists"

        # Create new branch
        if effective_base:
            # Verify base branch exists
            if effective_base not in existing_branches and effective_base not in [
                branch.name for branch in repo.remote().refs
            ]:
                return f"❌ Base branch '{effective_base}' not found"

            repo.create_head(branch_name, effective_base)
        else:
            repo.create_head(branch_name)

        return f"✅ Created branch '{branch_name}'"

    except GitCommandError as e:
        return f"❌ Branch creation failed: {str(e)}"
    except Exception as e:
        return f"❌ Branch creation error: {str(e)}"

src/mcp_server_git/git/models.py:66-70 (schema)
Pydantic schema/model for input validation of git_create_branch tool parameters.
```
class GitCreateBranch(BaseModel):
    repo_path: str
    branch_name: str
    base_branch: str | None = None
```
src/mcp_server_git/core/handlers.py:96-100 (registration)
Registration of the git_create_branch handler in the GitToolRouter via _get_git_handlers() method, wrapping the operations function with error handling and repo preparation.
```
"git_create_branch": self._create_git_handler(
    git_create_branch,
    requires_repo=True,
    extra_args=["branch_name", "base_branch"],
),
```

src/mcp_server_git/core/tools.py:238-245 (registration)

ToolDefinition registration in ToolRegistry for git_create_branch, including schema reference and metadata; handler later overridden by router.

ToolDefinition(
    name=GitTools.CREATE_BRANCH,
    category=ToolCategory.GIT,
    description="Create a new branch from an optional base branch",
    schema=GitCreateBranch,
    handler=placeholder_handler,
    requires_repo=True,
),

src/mcp_server_git/protected_git_operations.py:311-318 (helper)

Protected wrapper for git_create_branch that adds repository binding validation and remote integrity checks before calling the core handler.

async def protected_git_create_branch(
    self, repo_path: str, branch_name: str, base_branch: str | None = None
) -> str:
    """Git create branch with repository binding protection."""
    validated_path = await self._validate_and_prepare_operation(repo_path)
    repo = Repo(validated_path)
    return git_create_branch(repo, branch_name, base_branch)

MCP Git Server