GitLab-MCP-Server

GitLabとの連携機能を提供するModel Context Protocol (MCP) サーバーです。GitLabの特定のプロジェクトからパイプラインの失敗情報やマージリクエストへの指摘事項を取得し、AIアシスタントに提供します。

概要

このMCPサーバーは、GitLabのAPIを利用して以下の情報をAIアシスタントに提供します：

1. GitLabパイプラインで失敗したジョブのコンソール出力
2. GitLab MRへの未解決の指摘事項（コメント）
3. GitLab MRの変更内容（ローカルリポジトリの現在の状態との差分）

MCPの機能を使用することで、AIアシスタントはGitLabの情報を直接取得し、より的確な支援を提供できます。

インストール

# uvのインストール
$ curl -LsSf https://astral.sh/uv/install.sh | sh

$ cd /path/to/this-mcp-server
# ライブラリのインストール
$ uv sync

準備

GitLabのアクセストークンが必要です。 アクセストークンはGitLabの設定→アクセストークンにて発行してください。 発行する際、read_api にチェックを入れてください。

機能

1. パイプラインの失敗情報を取得して修正 (get_pipeline_failed_jobs)

GitLabパイプラインで失敗したジョブのコンソール出力を取得します。 取得した情報をもとにAIアシスタントによる修正が行われます。

出力:

• 失敗したジョブのコンソール出力（ジョブ名、ステータス、詳細なログを含む）

2. MRの指摘事項を取得して修正 (get_review_comments)

GitLab MRの未解決の指摘事項（コメント）を取得して対応します。 解決済みのコメントやファイルに紐づいていないコメントは除外されます。

出力:

• MRへの未解決かつファイルに紐づいている指摘事項（コメント者、時間、コメント内容、ファイル位置情報などを含む）

3. MRの変更内容を取得してレビュー (get_review_changes)

GitLab MRのベースコミット（base_sha）から現在のローカルリポジトリの状態までの差分を取得します。 リモートGitリポジトリの絶対パス リモートGitリポジトリの絶対パス リモートGitリポジトリの絶対パス リモートGitリポジトリの絶対パス リモートGitリポジトリの絶対パス リモートGitリポジトリの絶対パス

AI アシスタントとの連携

1. 失敗したジョブのコンソール出力の取得

from mcp_server import get_pipeline_failed_jobs

jobs = get_pipeline_failed_jobs()
for job in jobs:
    print(f"Job Name: {job['name']}")
    print(f"Status: {job['status']}")
    print(f"Log: {job['log']}\n")

2. MR の指摘事項の取得

from mcp_server import get_review_comments

comments = get_review_comments()
for comment in comments:
    print(f"Author: {comment['author']}")
    print(f"Time: {comment['time']}")
    print(f"Content: {comment['content']}\n")

3. MR の変更内容の取得

from mcp_server import get_review_changes

changes = get_review_changes()
for change in changes:
    print(f"File: {change['file']}")
    print(f"Type: {change['type']}")
    print(f"Differences: {change['differences']}\n")

注意事項

• 上記のコード例で、以下の値を適切に置き換えてください：
  • your_gitlab_api_key: GitLab APIのアクセストークン
  • /path/to/git/repo: ローカルGitリポジトリの絶対パス
  • /path/to/this-mcp-server: このMCPサーバーのディレクトリの絶対パス