gitlab-mcp-server

Alosies/gitlab-mcp-server

3.3

If you are the rightful owner of gitlab-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server that integrates with GitLab's REST API, enabling interaction with GitLab projects, issues, merge requests, and more through the MCP protocol.

The GitLab MCP Server is a powerful tool designed to facilitate seamless integration with GitLab's REST API. It allows users to manage various aspects of their GitLab projects, such as projects, issues, merge requests, pipelines, and more, through the Model Context Protocol (MCP). This server is particularly useful for developers and project managers who need to automate and streamline their workflows by interacting with GitLab programmatically. With support for listing and managing projects, issues, merge requests, and pipelines, the GitLab MCP Server provides a comprehensive solution for GitLab project management. It also includes features for retrieving job logs, managing branches, and accessing user information, making it a versatile tool for a wide range of GitLab-related tasks. The server is easy to set up and configure, requiring only Node.js, npm, and a GitLab personal access token. It supports both global installation via npm and installation from source, offering flexibility for different development environments.

Features

  • Projects: List and get details of GitLab projects.
  • Issues: List, get, and create issues in GitLab projects.
  • Merge Requests: List, get, and create merge requests.
  • Pipelines: Manage pipelines including listing, creating, retrying, and canceling.
  • User Information: Retrieve current authenticated user information.

Usages

npx with Claude Desktop

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@alosies/gitlab-mcp-server"],
      "env": {
        "NPM_CONFIG_TOKEN": "your-gitlab-token-here"
      }
    }
  }
}

global installation with Claude Desktop

{
  "mcpServers": {
    "gitlab": {
      "command": "gitlab-mcp-server",
      "env": {
        "NPM_CONFIG_TOKEN": "your-gitlab-token-here"
      }
    }
  }
}

development from source with Claude Desktop

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": ["/path/to/gitlab-mcp-server/dist/index.js"],
      "env": {
        "NPM_CONFIG_TOKEN": "your-gitlab-token-here"
      }
    }
  }
}

Tools

  1. list_projects

    List GitLab projects with optional filters.

  2. get_project

    Get detailed information about a specific project.

  3. list_issues

    List issues in a project with optional filters.

  4. get_issue

    Get detailed information about a specific issue.

  5. create_issue

    Create a new issue in a project.