GitLab MCP Server

Instructions

Implementation Reference

• tools/reply_to_review_comment.py:57-94 (handler)

  The main asynchronous handler function that executes the tool logic: extracts arguments, calls GitLab API to create a merge request discussion, formats success/error response as TextContent.

  async def create_review_comment(gitlab_url, project_id, access_token, args):
      """Create a new discussion thread in a merge request review"""
      logging.info(f"create_review_comment called with args: {args}")
  
      mr_iid = args["merge_request_iid"]
      comment_body = args["body"]
  
      try:
          status, response_data, error_text = await create_merge_request_discussion(
              gitlab_url, project_id, access_token, mr_iid, comment_body
          )
  
          if status == 201:
              author_name = response_data.get("author", {}).get("name", "Unknown")
              discussion_id = response_data.get("id", "unknown")
  
              result = "✅ **New discussion created!**\n\n"
              result += f"**Merge Request**: !{mr_iid}\n"
              result += f"**Discussion ID**: `{discussion_id}`\n"
              result += f"**Author**: {author_name}\n"
              result += f"**Comment**: {comment_body[:100]}{'...' if len(comment_body) > 100 else ''}\n"
  
              return [TextContent(type="text", text=result)]
          else:
              error_msg = "❌ **Error creating discussion**\n\n"
              error_msg += f"**Status**: {status}\n"
              error_msg += f"**Error**: {error_text}\n"
              error_msg += f"**MR**: !{mr_iid}\n"
  
              return [TextContent(type="text", text=error_msg)]
  
      except Exception as e:
          logging.error(f"Unexpected error in create_review_comment: {e}")
          error_result = "❌ **Unexpected error**\n\n"
          error_result += f"**Error**: {str(e)}\n"
          error_result += f"**MR**: !{mr_iid}\n"
  
          return [TextContent(type="text", text=error_result)]

• main.py:215-231 (schema)

  Input schema definition for the tool, specifying required parameters merge_request_iid (integer) and body (string), registered in the list_tools handler.

  Tool(
      name="create_review_comment",
      description=("Create a new discussion thread in a " "merge request review"),
      inputSchema={
          "type": "object",
          "properties": {
              "merge_request_iid": {
                  "type": "integer",
                  "minimum": 1,
                  "description": ("Internal ID of the merge request"),
              },
              "body": {"type": "string", "description": ("Content of the new discussion comment")},
          },
          "required": ["merge_request_iid", "body"],
          "additionalProperties": False,
      },
  ),

• main.py:336-339 (registration)

  Registration and dispatch logic in the call_tool handler that invokes the create_review_comment function with config and arguments when the tool name matches.

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