Git MCP

Instructions

Args:
    repo_name: Name of the git repository
    tag_name: Name of the tag to push

Returns:
    Dictionary containing status and information about the operation

Implementation Reference

• git_mcp/server.py:219-269 (handler)

  The handler function decorated with @mcp.tool(), which registers and implements the push_git_tag tool. It validates the repo and tag, finds the default remote, pushes the tag, and returns status info.

  @mcp.tool()
  def push_git_tag(ctx: Context, repo_name: str, tag_name: str) -> Dict[str, str]:
      """Push a git tag to the default remote
  
      Args:
          repo_name: Name of the git repository
          tag_name: Name of the tag to push
  
      Returns:
          Dictionary containing status and information about the operation
      """
      git_repos_path = ctx.request_context.lifespan_context.git_repos_path
      repo_path = os.path.join(git_repos_path, repo_name)
  
      # Validate repository exists
      if not os.path.exists(repo_path) or not os.path.exists(
          os.path.join(repo_path, ".git")
      ):
          raise ValueError(f"Repository not found: {repo_name}")
  
      # Validate tag exists
      try:
          _run_git_command(repo_path, ["tag", "-l", tag_name])
      except ValueError:
          return {
              "status": "error",
              "error": f"Tag {tag_name} not found in repository {repo_name}",
          }
  
      # Get the default remote (usually 'origin')
      try:
          remote = _run_git_command(repo_path, ["remote"])
          if not remote:
              return {
                  "status": "error",
                  "error": f"No remote configured for repository {repo_name}",
              }
          # Use the first remote if multiple are available
          default_remote = remote.split("\n")[0].strip()
  
          # Push the tag to the remote
          push_result = _run_git_command(repo_path, ["push", default_remote, tag_name])
  
          return {
              "status": "success",
              "remote": default_remote,
              "tag": tag_name,
              "message": f"Successfully pushed tag {tag_name} to remote {default_remote}",
          }
      except ValueError as e:
          return {"status": "error", "error": str(e)}

• git_mcp/server.py:34-48 (helper)

  Helper utility function used by the push_git_tag handler (and others) to safely execute git commands in a repository context, capturing output and raising errors appropriately.

  def _run_git_command(repo_path: str, command: List[str]) -> str:
      """Run a git command in the specified repository path"""
      if not os.path.exists(repo_path):
          raise ValueError(f"Repository path does not exist: {repo_path}")
  
      full_command = ["git"] + command
      try:
          result = subprocess.run(
              full_command, cwd=repo_path, check=True, capture_output=True, text=True
          )
          return result.stdout.strip()
      except subprocess.CalledProcessError as e:
          error_message = e.stderr.strip() if e.stderr else str(e)
          raise ValueError(f"Git command failed: {error_message}")