Custom GitLab MCP Server

An AI-based code review tool for GitLab merge requests that uses Anthropic's Claude model to automatically analyze code quality, style, and security issues and provides review suggestions.

Developer tools Version control #Code Review #AI Tool #GitLab Integration #Automation Remote .TypeScript

rating : 2 points

downloads : 10.4K

update time : 2025-04-28

Open Site

What is GitLab MR Reviewer?

GitLab MR Reviewer is an AI-assisted automatic code review tool used to check and evaluate the code quality, style consistency, security issues, and compliance with team standards in GitLab merge requests.

Key Features

This tool provides automated code review functionality by integrating the Claude AI model. It can identify potential code issues and offer suggestions and feedback to developers, thereby improving code quality and development efficiency.

Use Cases

It is suitable for any team or project that requires strict code quality management. Whether you're an individual developer or a large enterprise, you can simplify the code review process and reduce human errors through this tool.

Features

Automated Code Review

Analyze code in real-time to detect potential issues and risks.

Style Consistency Check

Ensure that the code complies with the team's coding standards and best practices.

Security Assessment

Identify potential security vulnerabilities and prevent common security issues.

Integration Support

Seamlessly integrate with the GitLab API to provide a unified code review experience.

How to Use

Install the necessary dependencies: npm install

Configure the GitLab API access token and Claude API key. Add the settings to the.env file.

Initialize the project and run the service: npm start

Frequently Asked Questions

Which Claude models are supported?

Can I customize the review checklist?

How do I set up Slack notifications?

What permissions does the GitLab token need?

More Resources

GitLab API Documentation

Official GitLab API reference documentation.

Claude API Documentation

Anthropic's Claude API documentation.

Example Configurations

Example configurations set by different teams.

🚀 GitLab Code Merge Request Review Bot

This is an AI-powered dynamic GitLab merge request code review tool integrated with Anthropic's Claude model. It can provide automated code reviews and checklist compliance assessments.

🚀 Quick Start

Prerequisites

Node.js (v14 or higher)
npm or yarn
A GitLab account with API access
Anthropic Claude API key

Installation

Clone the repository:

git clone <repository-url>
cd gitlab-mr-reviewer

Install dependencies:
```
npm install
```
Copy the example environment file and update it with your configuration:
```
cp .env.example .env
```
Edit the .env file and replace the relevant values with your GitLab and Claude credentials.

Configuration

Update the following variables in the .env file:

# GitLab configuration
GITLAB_API_URL=https://gitlab.example.com/api/v4
GITLAB_PRIVATE_TOKEN=your_private_token_here
GITLAB_WEBHOOK_SECRET=your_webhook_secret_here

# Anthropic Claude configuration
CLAUDE_API_KEY=your_claude_api_key_here
CLAUDE_MODEL=claude-3-opus-20240229

# Application configuration
PORT=3000
NODE_ENV=development

# Logging configuration
LOG_LEVEL=info

# Slack notifications (optional)
SLACK_WEBHOOK_URL=your_slack_webhook_url_here

✨ Features

Automatically conduct code reviews when a merge request is opened or updated.
Analyze code for style, quality, security issues, and best practices.
Perform custom checklist evaluations on MRs according to team standards.
Provide detailed feedback for each file.
Give an overall assessment and offer final suggestions (approve, approve with minor revisions, require modifications).
Can be triggered automatically via GitLab webhook or manually.
Send notifications to Slack (optional).

💻 Usage Examples

Basic Usage

The tool will automatically start code reviews when a merge request is opened or updated. You can also manually trigger the review.

Advanced Usage

You can customize the merge request checklist according to your team's needs. The checklist is implemented through the MR_CHECKLIST constant in src/services/claude.service.js.

📚 Documentation

Merge Request Checklist

The tool performs the following checks on each merge request according to team standards:

The change description is clear and complete.
A Trello card is linked.
The version number in version.json has been incremented.
The Trello card has detailed descriptions.
If necessary, the proto file has been updated.
Error handling (try - catch) is correctly implemented, and Slack notifications are added in appropriate places.
The function length does not exceed 50 lines (or there is an explanation).
The merge request focuses on a single purpose (logical change or refactoring).
Unit tests have been added.
The documentation has been updated.