Gitlab MCP

An improved GitLab MCP server that provides rich GitLab operation interfaces and enhanced features

Version control Developer tools #GitLab integration #Code management #Development tools #API services .TypeScript

rating : 2.5 points

downloads : 80

update time : 2025-04-28

What is the Better GitLab MCP Server?

The Better GitLab MCP Server is a tool based on the GitLab API that allows users to perform project management, file operations, branch management, and merge request processing through the Model Context Protocol (MCP).

How to use the Better GitLab MCP Server?

Simply set the necessary environment variables and use the provided commands to start operating your GitLab projects.

Applicable scenarios

Suitable for enterprises, development teams, and individual developers who need to automate GitLab project management.

Main features

Create or update a fileCreate or update a single file in a GitLab project.

Push multiple filesCommit multiple files to a GitLab project at once.

Search repositoriesSearch for GitLab projects based on keywords.

Create a new repositoryQuickly create a new GitLab project.

Get file contentsRead the contents of a file or directory in a GitLab project.

Create an issueCreate a new issue in a GitLab project.

Create a merge requestInitiate a new merge request.

Fork a repositoryFork an existing project on GitLab.

Create a new branchCreate a new branch in a GitLab project.

Get merge request detailsView detailed information about a specific merge request.

Update a merge requestModify the status or information of an existing merge request.

Add a commentAdd a new comment to an issue or merge request.

List projectsFilter and list available GitLab projects.

List labelsGet all labels in a project.

Get a single labelGet detailed information about a label in a specific project.

Create a new labelAdd a new label to a project.

Update a labelModify the information of an existing label.

Delete a labelRemove a specified label from a project.

List group projectsList all projects in a GitLab group.

Advantages and limitations

Advantages

Supports multiple GitLab operations, improving work efficiency.

Enhanced read - write permission control to ensure data security.

Rich API interfaces for easy integration into other systems.

Performance optimization to improve response speed.

Limitations

Requires configuration of a personal access token, which may be complex for beginners.

Some advanced features may depend on GitLab Enterprise Edition.

Network latency may affect the efficiency of remote operations.

How to use

Install dependencies

Ensure that Node.js and npm are installed.

Set environment variables

Configure the GitLab personal access token and API URL.

Run the server

Start the Better GitLab MCP Server.

Usage examples

Create a new fileCreate a new file named 'README.md' in a GitLab project.

Create a merge requestCreate a merge request from the 'feature - branch' to the'main' branch.

Frequently Asked Questions

How to set up a personal access token?

Why can't I connect to the GitLab API?

How to restrict read - write permissions?

Related resources

Official documentation

Official documentation for the GitLab API.

GitHub repository

Source code for the Better GitLab MCP Server.

Video tutorial

Quick - start video.

🚀 GitLab API Documentation

This documentation provides a detailed guide on using the GitLab API, including how to manage projects, groups, labels, and configure environment variables.

🚀 Quick Start

Before using the GitLab API, you need to set the following environment variables:

GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token
GITLAB_API_URL=your_gitlab_api_url  # Default: https://gitlab.com/api/v4
GITLAB_READ_ONLY_MODE=true          # Optional: Enable read-only mode

✨ Features

Project Management: Retrieve and create projects.
Group Project Management: Get projects within a specific group.
Label Management: List project labels.
Environment Variable Configuration: Set necessary environment variables for API access.

📦 Installation

No specific installation steps are required for using the API. Just ensure the environment variables are correctly set.

💻 Usage Examples

Project List

Get a Single Project

Endpoint: /projects/{project_id}
Method: GET
Parameters:
- include_subgroups: Whether to include projects from subgroups, default is false.
- statistics: Whether to return project statistics, optional values: true or false.

Create a New Project

Endpoint: /projects
Method: POST
Request Body:

{
    "name": string,
    "description": string,
    "visibility": string,
    "namespace": string,
    "ssh_url": string,
    "http_url": string,
    "auto_clone": boolean
}

Group Project List

Get Projects in a Single Group

Endpoint: /groups/{group_id}/projects
Method: GET
Parameters:
- include_subgroups: Whether to include projects from subgroups, default is false.
- search: Search keyword to filter by project name or description.
- archived: Whether to include archived projects, default is false.

Label Management

List Project Labels

Endpoint: /projects/{project_id}/labels
Method: GET
Parameters:
- with_counts: Whether to include the number of issues and merge requests for each label, default is false.
- include_ancestor_groups: Whether to include labels from ancestor groups, default is false.

📚 Documentation

This README serves as the main documentation for the GitLab API usage. It covers the main endpoints and parameters for project, group project, and label management.