コードレビューのためのGitLab MCP

Name: GitLab MCP for Code Review
Author: mehmetakinn

Python 3.10以上ライセンス: MIT

このプロジェクトは、cayirtepeomer/gerrit-code-review-mcpからフォークされ、GitLab 統合用に適応されています。

ClaudeのようなAIアシスタントをGitLabのマージリクエストに統合するためのMCP（Model Context Protocol）サーバー。これにより、AIアシスタントはGitLab APIを介して直接コード変更をレビューできるようになります。

特徴

完全なマージリクエスト分析: 差分、コミット、コメントを含むマージリクエストの完全な詳細を取得します
ファイル固有の差分: マージリクエスト内の特定のファイルの変更を分析する
バージョン比較: 異なるブランチ、タグ、コミットを比較します
レビュー管理: コメントの追加、マージリクエストの承認または承認解除
プロジェクト概要: プロジェクト内のすべてのマージリクエストのリストを取得する

Related MCP server: GitLab MCP Server

インストール

前提条件

Python 3.10以上
API スコープ (read_api、api) を持つ GitLab 個人アクセストークン
MCP 統合用のCursor IDEまたはClaude デスクトップアプリ

クイックスタート

このリポジトリをクローンします:

git clone https://github.com/mehmetakinn/gitlab-mcp-code-review.git cd gitlab-mcp-code-review

仮想環境を作成してアクティブ化します。

python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate

依存関係をインストールします:

pip install -r requirements.txt

GitLab 設定で.envファイルを作成します (すべてのオプションについては.env.example参照してください)。

# Required GITLAB_TOKEN=your_personal_access_token_here # Optional settings GITLAB_HOST=gitlab.com GITLAB_API_VERSION=v4 LOG_LEVEL=INFO

設定オプション

.envファイルでは次の環境変数を設定できます。

変数	必須	デフォルト	説明
GITLAB_トークン	はい	-	GitLab個人アクセストークン
GITLAB_ホスト	いいえ	gitlab.com	GitLabインスタンスのホスト名
GITLAB_API_バージョン	いいえ	v4	使用するGitLab APIバージョン
ログレベル	いいえ	情報	ログレベル（DEBUG、INFO、WARNING、ERROR、CRITICAL）
デバッグ	いいえ	間違い	デバッグモードを有効にする
リクエストタイムアウト	いいえ	30	APIリクエストのタイムアウト（秒）
最大再試行回数	いいえ	3	失敗したリクエストの最大再試行回数

カーソルIDE統合

この MCP を Cursor IDE で使用するには、次の構成を~/.cursor/mcp.jsonファイルに追加します。

{ "mcpServers": { "gitlab-mcp-code-review": { "command": "/path/to/your/gitlab-mcp-code-review/.venv/bin/python", "args": [ "/path/to/your/gitlab-mcp-code-review/server.py", "--transport", "stdio" ], "cwd": "/path/to/your/gitlab-mcp-code-review", "env": { "PYTHONPATH": "/path/to/your/gitlab-mcp-code-review", "VIRTUAL_ENV": "/path/to/your/gitlab-mcp-code-review/.venv", "PATH": "/path/to/your/gitlab-mcp-code-review/.venv/bin:/usr/local/bin:/usr/bin:/bin" }, "stdio": true } } }

/path/to/your/gitlab-mcp-code-reviewクローンしたリポジトリへの実際のパスに置き換えます。

クロードデスクトップアプリ統合

この MCP を Claude デスクトップアプリで使用するには:

Claudeデスクトップアプリを開く
設定→詳細設定→MCP構成に移動します
次の構成を追加します。

/path/to/your/gitlab-mcp-code-reviewクローンしたリポジトリへの実際のパスに置き換えます。

利用可能なツール

MCP サーバーは、GitLab と対話するための次のツールを提供します。

道具	説明
`fetch_merge_request`	マージリクエストに関する完全な情報を取得する
`fetch_merge_request_diff`	特定のマージリクエストの差分を取得する
`fetch_commit_diff`	特定のコミットの差分情報を取得する
`compare_versions`	異なるブランチ、タグ、コミットを比較する
`add_merge_request_comment`	マージリクエストにコメントを追加する
`approve_merge_request`	マージリクエストを承認する
`unapprove_merge_request`	マージリクエストを承認しない
`get_project_merge_requests`	プロジェクトのマージリクエストのリストを取得する

使用例

マージリクエストを取得する

# Get details of merge request #5 in project with ID 123 mr = fetch_merge_request("123", "5")

特定のファイルの変更を表示する

# Get diff for a specific file in a merge request file_diff = fetch_merge_request_diff("123", "5", "path/to/file.js")

ブランチを比較する

# Compare develop branch with master branch diff = compare_versions("123", "develop", "master")

マージリクエストにコメントを追加する

# Add a comment to a merge request comment = add_merge_request_comment("123", "5", "This code looks good!")

マージリクエストを承認する

# Approve a merge request and set required approvals to 2 approval = approve_merge_request("123", "5", approvals_required=2)

トラブルシューティング

問題が発生した場合:

GitLabトークンに適切な権限（api、read_api）があることを確認します
.envファイルの設定を確認してください
MCP構成パスが正しいことを確認してください
次のコマンドで接続をテストします: curl -H "Private-Token: your-token" https://gitlab.com/api/v4/projects
より詳細なログ記録を行うには、.env ファイルで LOG_LEVEL=DEBUG を設定します。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

開発プロセスの詳細については、 CONTRIBUTING.mdファイルを参照してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

GitLab MCP for Code Review