MCP Git Server

Instructions

Implementation Reference

• src/mcp_server_git/github/api.py:263-327 (handler)

  The core handler function that implements the github_get_workflow_run tool. Fetches workflow run details and associated jobs from the GitHub Actions API, formats them with status emojis and timing information.

  async def github_get_workflow_run(
      repo_owner: str, repo_name: str, run_id: int, include_logs: bool = False
  ) -> str:
      """Get detailed workflow run information"""
      try:
          async with github_client_context() as client:
              # Get workflow run details
              run_response = await client.get(
                  f"/repos/{repo_owner}/{repo_name}/actions/runs/{run_id}"
              )
              if run_response.status != 200:
                  return f"❌ Failed to get workflow run #{run_id}: {run_response.status}"
  
              run_data = await run_response.json()
  
              output = [f"Workflow Run #{run_id}:\n"]
              output.append(f"Name: {run_data.get('name', 'N/A')}")
              output.append(f"Status: {run_data.get('status', 'N/A')}")
              output.append(f"Conclusion: {run_data.get('conclusion', 'N/A')}")
              output.append(f"Branch: {run_data.get('head_branch', 'N/A')}")
              output.append(f"Commit: {run_data.get('head_sha', 'N/A')[:8]}")
              output.append(f"Started: {run_data.get('created_at', 'N/A')}")
              output.append(f"Updated: {run_data.get('updated_at', 'N/A')}")
  
              if run_data.get("html_url"):
                  output.append(f"URL: {run_data['html_url']}")
  
              # Get jobs if available
              jobs_response = await client.get(
                  f"/repos/{repo_owner}/{repo_name}/actions/runs/{run_id}/jobs"
              )
              if jobs_response.status == 200:
                  jobs_data = await jobs_response.json()
                  jobs = jobs_data.get("jobs", [])
  
                  if jobs:
                      output.append("\nJobs:")
                      for job in jobs:
                          status_emoji = {
                              "completed": "✅"
                              if job.get("conclusion") == "success"
                              else "❌",
                              "in_progress": "🔄",
                              "queued": "⏳",
                          }.get(job["status"], "❓")
  
                          output.append(f"  {status_emoji} {job['name']}")
                          output.append(f"    Status: {job['status']}")
                          if job.get("conclusion"):
                              output.append(f"    Conclusion: {job['conclusion']}")
  
              return "\n".join(output)
  
      except ValueError as auth_error:
          logger.error(f"Authentication error getting workflow run: {auth_error}")
          return f"❌ {str(auth_error)}"
      except ConnectionError as conn_error:
          logger.error(f"Connection error getting workflow run: {conn_error}")
          return f"❌ Network connection failed: {str(conn_error)}"
      except Exception as e:
          logger.error(
              f"Unexpected error getting workflow run #{run_id}: {e}", exc_info=True
          )
          return f"❌ Error getting workflow run: {str(e)}"

• src/mcp_server_git/github/models.py:22-27 (schema)

  Pydantic model defining the input schema for the github_get_workflow_run tool, including required repository details and run_id, with optional include_logs flag.

  class GitHubGetWorkflowRun(BaseModel):
      repo_owner: str
      repo_name: str
      run_id: int
      include_logs: bool = False

• src/mcp_server_git/core/handlers.py:208-211 (registration)

  Registration of the tool handler in the GitToolRouter. Creates a wrapped async handler using _create_github_handler that calls the api implementation with proper argument mapping and error handling.

  "github_get_workflow_run": self._create_github_handler(
      github_get_workflow_run,
      ["repo_owner", "repo_name", "run_id", "include_logs"],
  ),

• src/mcp_server_git/core/tools.py:357-364 (registration)

  ToolDefinition registration in the central ToolRegistry. Defines the tool metadata, schema reference, category (GITHUB), and flags for repo/token requirements. Handler placeholder later replaced by router.

      name=GitTools.GITHUB_GET_WORKFLOW_RUN,
      category=ToolCategory.GITHUB,
      description="Get detailed workflow run information",
      schema=GitHubGetWorkflowRun,
      handler=placeholder_handler,
      requires_repo=False,
      requires_github_token=True,
  ),

• src/mcp_server_git/core/tools.py:43-43 (registration)

  Enum definition in GitTools that provides the canonical string name for the tool used in registrations.

  GITHUB_GET_WORKFLOW_RUN = "github_get_workflow_run"