Owayo Gitlab MCP Server

🚀 GitLab-MCP-Server

このサーバーはModel Context Protocol (MCP) を用いて、GitLabと連携する機能を提供します。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

✨ 主な機能

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

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

出力:

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

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

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

出力:

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

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

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

💻 使用例

基本的な使用法

# 失敗したジョブのコンソール出力の取得
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")

# 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")

# 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サーバーのディレクトリの絶対パス