GitLab MCP Server

Instructions

Implementation Reference

• tools/get_merge_request_reviews.py:135-229 (handler)

  Main tool handler: Fetches and formats comprehensive MR review report including approvals, discussions (resolved/unresolved), details, pipeline status, changes, readiness analysis, detailed threads with icons/authors/files/lines, and prioritized action items.

  async def get_merge_request_reviews(gitlab_url, project_id, access_token, args):
      logging.info(f"get_merge_request_reviews called with args: {args}")
      mr_iid = args["merge_request_iid"]
  
      tasks = [
          api_get_merge_request_reviews(gitlab_url, project_id, access_token, mr_iid),
          get_merge_request_details(gitlab_url, project_id, access_token, mr_iid),
          get_merge_request_pipeline(gitlab_url, project_id, access_token, mr_iid),
          get_merge_request_changes(gitlab_url, project_id, access_token, mr_iid),
      ]
  
      try:
          reviews_result, details_result, pipeline_result, changes_result = await asyncio.gather(*tasks)
      except Exception as e:
          logging.error(f"Error in parallel API calls: {e}")
          raise Exception(f"Error fetching merge request data: {e}")
  
      discussions_status, discussions, discussions_text = reviews_result["discussions"]
      approvals_status, approvals, approvals_text = reviews_result["approvals"]
  
      details_status, mr_details, details_text = details_result
      pipeline_status, pipeline_data, pipeline_text = pipeline_result
      changes_status, changes_data, changes_text = changes_result
  
      if discussions_status != 200:
          logging.error(f"Error fetching discussions {discussions_status}: {discussions_text}")
          raise Exception(f"Error fetching discussions: {discussions_status} - {discussions_text}")
  
      result = f"# 🔍 Reviews & Discussions for MR !{mr_iid}\n\n"
  
      if details_status == 200:
          result += "## 📋 Merge Request Overview\n"
          result += f"**Title**: {mr_details.get('title', 'N/A')}\n"
          state = mr_details.get("state", "N/A")
          result += f"**Status**: {state} ({get_state_explanation(state)})\n"
          author = mr_details.get("author", {})
          author_name = author.get("name", "N/A")
          author_username = author.get("username", "N/A")
          result += f"**Author**: {author_name} (@{author_username})\n"
          result += f"**Priority**: {get_mr_priority(mr_details)}\n"
  
          if pipeline_status == 200 and pipeline_data:
              pipeline_icon = get_pipeline_status_icon(pipeline_data.get("status"))
              result += f"**Pipeline**: {pipeline_icon} {pipeline_data.get('status', 'unknown')}\n"
  
          if changes_status == 200:
              change_stats = calculate_change_stats(changes_data)
              result += f"**Changes**: {change_stats}\n"
  
          readiness = analyze_mr_readiness(mr_details, pipeline_data, approvals)
          result += f"**Merge Status**: {readiness}\n"
  
          result += f"**Updated**: {format_date(mr_details.get('updated_at', 'N/A'))}\n\n"
  
      result += get_approval_summary(approvals)
  
      result += get_discussion_summary(discussions)
  
      if discussions:
          result += "## 📝 Detailed Discussions\n\n"
          for discussion in discussions:
              thread_content = format_discussion_thread(discussion)
              if thread_content:
                  result += thread_content
      else:
          result += "💬 No discussions found\n\n"
  
      result += "## 📊 Action Items\n"
      action_items = []
  
      if discussions:
          unresolved_count = sum(1 for d in discussions if not d.get("resolved"))
          if unresolved_count > 0:
              action_items.append(
                  f"🟡 Resolve {unresolved_count} pending discussion{'s' if unresolved_count > 1 else ''}"
              )
  
      if approvals and approvals.get("approvals_left", 0) > 0:
          action_items.append(
              f"👥 Obtain {approvals['approvals_left']} more approval{'s' if approvals['approvals_left'] > 1 else ''}"
          )
  
      if pipeline_status == 200 and pipeline_data and pipeline_data.get("status") == "failed":
          action_items.append("❌ Fix failing pipeline")
  
      if details_status == 200 and mr_details.get("has_conflicts"):
          action_items.append("⚠️ Resolve merge conflicts")
  
      if action_items:
          for item in action_items:
              result += f"• {item}\n"
      else:
          result += "✅ No action items - ready for next steps\n"
  
      return [TextContent(type="text", text=result)]

• main.py:69-85 (schema)

  Tool schema definition in list_tools(): Specifies input as object with required integer merge_request_iid >=1.

  Tool(
      name="get_merge_request_reviews",
      description=("Get reviews and discussions for a specific " "merge request"),
      inputSchema={
          "type": "object",
          "properties": {
              "merge_request_iid": {
                  "type": "integer",
                  "minimum": 1,
                  "description": ("Internal ID of the merge request"),
              }
          },
          "required": ["merge_request_iid"],
          "additionalProperties": False,
      },
  ),
  Tool(

• main.py:304-307 (registration)

  Tool dispatch registration in call_tool(): Maps tool name to handler invocation with config params.

  elif name == "get_merge_request_reviews":
      return await get_merge_request_reviews(
          self.config["gitlab_url"], self.config["project_id"], self.config["access_token"], arguments
      )

• gitlab_api.py:82-100 (helper)

  Core API helper (aliased as api_get_merge_request_reviews): Fetches paginated MR discussions and approvals data.

  async def get_merge_request_reviews(gitlab_url, project_id, access_token, mr_iid):
      discussions_result = await get_merge_request_discussions_paginated(gitlab_url, project_id, access_token, mr_iid)
      discussions_status, discussions, discussions_text = discussions_result
  
      approvals_url = f"{gitlab_url}/api/v4/projects/{project_id}/merge_requests/{mr_iid}/approvals"
      headers = _headers(access_token)
      async with aiohttp.ClientSession() as session:
          async with session.get(approvals_url, headers=headers) as approvals_response:
              if approvals_response.status == 200:
                  approvals = await approvals_response.json()
              else:
                  approvals = None
              approvals_status = approvals_response.status
              approvals_text = await approvals_response.text()
  
      return {
          "discussions": (discussions_status, discussions, discussions_text),
          "approvals": (approvals_status, approvals, approvals_text),
      }

• tools/get_merge_request_reviews.py:32-63 (helper)

  Helper function to format approval summary with approver list, status, required vs received counts.

  def get_approval_summary(approvals):
      """Generate enhanced approval summary"""
      if not approvals:
          return "## 👥 Approvals\n❓ No approval information available\n\n"
  
      result = "## 👥 Approvals\n"
  
      approved_by = approvals.get("approved_by", [])
      approvals_required = approvals.get("approvals_required", 0)
      approvals_left = approvals.get("approvals_left", 0)
  
      if approved_by:
          result += f"**✅ Approved by ({len(approved_by)} reviewer"
          result += f"{'s' if len(approved_by) > 1 else ''}):**\n"
          for approval in approved_by:
              user = approval["user"]
              result += f"  • **{user['name']}** (@{user['username']})\n"
          result += "\n"
  
      if approvals_required > 0:
          if approvals_left == 0:
              status = "✅ Approval requirements met"
          else:
              plural = "s" if approvals_left > 1 else ""
              status = f"⏳ {approvals_left} approval{plural} needed"
          result += f"**Status**: {status}\n"
          received_count = len(approved_by)
          result += f"**Required**: {approvals_required} | **Received**: {received_count}\n\n"
      elif not approved_by:
          result += "📝 No approvals yet\n\n"
  
      return result