https://github.com/owayo/gitlab-mcp-server

Instructions

Implementation Reference

• main.py:79-93 (handler)

  The main handler for the 'get_review_comments' tool. It determines the current MR ID, fetches the unresolved comments using get_mr_comments, and formats them into a user-friendly message prompting the user to address them.

  @mcp.tool()
  def get_review_comments() -> str:
      """GitLab MRの未解決の指摘事項（コメント）を取得"""
      mr_id = get_current_mr_id()
  
      mr_comments = get_mr_comments(mr_id=mr_id)
      if mr_comments:
          return f"""
  以下の指摘事項に対応してください。対応後は今後へのアドバイスを出力してください。
  
  {mr_comments}
  """
      else:
          return f"MR #{mr_id} への未解決の指摘事項はありません。"

• main.py:30-44 (helper)

  Helper function to retrieve the Merge Request ID (MRID) for the current Git branch by calling get_merge_request.

  # カレントのブランチのMRIDを取得
  def get_current_mr_id() -> int:
      """
      現在のブランチのMRIDを取得します。
  
      Returns:
          int: 現在のブランチのMRID
      """
      branch_name = get_current_branch()
      mr = get_merge_request(branch_name)
      if mr:
          return mr.iid
      else:
          return "現在のブランチに関連するMerge Requestが見つかりません。"

• src/utils/gitlab_utils.py:218-264 (helper)

  Core helper function that fetches unresolved, file-associated comments from a GitLab Merge Request discussions using the GitLab API, processes them with process_discussion, and formats into a string.

  def get_mr_comments(mr_id: int) -> str:
      """
      指定したMR IDに関連するMRの指摘事項（コメント）を取得します。
      解決済み（resolved）のコメントは除外されます。
      ファイルに紐づいているコメントのみが取得されます。
  
      Args:
          mr_id (int): Merge Request ID
  
      Returns:
          str: MRへの指摘事項（AIが理解しやすい形式に整形）
  
      Raises:
          ValueError: コメントの取得に失敗した場合
      """
      try:
          project = get_gitlab_project()
  
          # MRを取得
          try:
              mr: MergeRequest = project.mergerequests.get(mr_id)
          except gitlab.exceptions.GitlabGetError:
              return f"MR ID #{mr_id} が見つかりません。"
  
          # MRのディスカッション（スレッド）を取得
          discussions = mr.discussions.list()
  
          if not discussions:
              return f"MR #{mr.iid} へのコメントはありません。"
  
          comments: List[str] = []
  
          # 各ディスカッションを処理
          for discussion in discussions:
              # 個々のディスカッション内のノートを処理
              discussion_comments = process_discussion(discussion)
              if discussion_comments:
                  comments.extend(discussion_comments)
  
          if not comments:
              return f"MR #{mr.iid} への未解決の指摘事項はありません。"
  
          return "\n---\n".join(comments)
  
      except Exception as e:
          raise ValueError(f"MRへの指摘事項の取得に失敗しました: {str(e)}")

• src/utils/gitlab_utils.py:266-325 (helper)

  Supporting helper that processes individual discussion threads, filters for unresolved file-associated comments, and formats them with author, location, and body.

  def process_discussion(discussion: Dict[str, Any]) -> List[str]:
      """
      ディスカッション（スレッド）内のノートを処理し、未解決のコメントを抽出します。
      ファイルに紐づいているコメントのみを抽出します。
  
      Args:
          discussion: GitLabディスカッションオブジェクト
  
      Returns:
          List[str]: 未解決のコメント文字列のリスト
      """
      discussion_comments = []
      has_unresolved_notes = False
  
      # ディスカッションにはノートの配列が含まれています
      notes = (
          discussion.attributes.get("notes", [])
          if hasattr(discussion, "attributes")
          else discussion.get("notes", [])
      )
  
      for note in notes:
          # システムノートは除外
          if note.get("system", False):
              continue
  
          # 解決可能で、かつ解決済みのノートは除外
          if note.get("resolvable", False) and note.get("resolved", False):
              continue
  
          # コードとの関連付けがあるか確認
          position = note.get("position", {})
          file_path = position.get("new_path", "") if position else ""
  
          # ファイルに紐づいていないコメントは除外
          if not file_path:
              continue
  
          # ここに到達したノートは未解決かつファイルに紐づいている
          has_unresolved_notes = True
  
          author = note.get("author", {}).get("name", "不明なユーザー")
          body = note.get("body", "")
          line = position.get("new_line", "") if position else ""
  
          location = (
              f" (ファイル: {file_path}, 行: {line})"
              if file_path and line
              else f" (ファイル: {file_path})"
          )
  
          discussion_comments.append(
              f"# 対象: {location}\n- コメント者: {author}\n- コメント:\n```\n{body}\n```"
          )
  
      # ディスカッションに未解決のノートがある場合のみ、そのコメントを返す
      if has_unresolved_notes:
          return discussion_comments
      return []