refresh_repository
Update local Git repositories by checking out the main branch and pulling all remote changes. Use this tool to ensure your repository is current and synchronized with the latest updates.
Instructions
Refresh repository by checking out main branch and pulling all remotes
Args:
repo_name: Name of the git repository
Returns:
Dictionary containing status and information about the operationInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| repo_name | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- git_mcp/server.py:272-337 (handler)The handler function for the refresh_repository tool, registered via @mcp.tool(). It validates the repository, checks out the main or master branch, fetches and pulls the latest changes from all configured remotes, and returns the status and results.
@mcp.tool() async def refresh_repository(ctx: Context, repo_name: str) -> Dict: """Refresh repository by checking out main branch and pulling all remotes Args: repo_name: Name of the git repository Returns: Dictionary containing status and information about the operation """ git_ctx = ctx.get_context(GitContext) repo_path = os.path.join(git_ctx.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}") try: # Get all remotes remotes = _run_git_command(repo_path, ["remote"]).strip().split("\n") if not remotes or remotes[0] == "": return { "status": "error", "error": f"No remotes configured for repository {repo_name}", } # Checkout main branch try: _run_git_command(repo_path, ["checkout", "main"]) except ValueError as e: # Try master if main doesn't exist try: _run_git_command(repo_path, ["checkout", "master"]) except ValueError: return { "status": "error", "error": f"Failed to checkout main or master branch: {str(e)}", } # Pull from all remotes pull_results = {} for remote in remotes: if remote: # Skip empty remote names try: result = _run_git_command(repo_path, ["pull", remote, "main"]) pull_results[remote] = "success" except ValueError as e: # Try master if main doesn't exist try: result = _run_git_command(repo_path, ["pull", remote, "master"]) pull_results[remote] = "success" except ValueError as e: pull_results[remote] = f"error: {str(e)}" return { "status": "success", "repository": repo_name, "branch": "main", "pull_results": pull_results, } except Exception as e: return {"status": "error", "error": f"Failed to refresh repository: {str(e)}"}