gitlab-mcp-server

Gitlab MCP (ModelContextProvider) server

📦 Installation

Prerequisites

Python 3.11 or higher
Running MCP server(s)
Cursor as MCP client
Podman(If running as containers)

Method 1: local setup in venv

git clone git@github.com:redhat-ai-tools/gitlab-mcp.git
cd gitlab-mcp
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Set MCP env vars, if not set everything else will fallback to default except MCP_GITLAB_TOKEN. If everything is set, Test this setup using:

python gitlab_mcp_server.py
INFO:__main__:🔒 Max API calls/hour: 100
INFO:__main__:🔒 Allowed actions: ['read']
INFO:__main__:🔒 Allowed repos: [<your allowed repo list>]
INFO:__main__:🔗 GitLab URL: <if gitlab URL is provided it will show up here, else the default value will appear>
🚀 Starting GitLab MCP Server (FastMCP - Read-Only)...
📋 Available Tools:
   🔍 search_repositories - Search/filter repositories
   📋 list_issues - List project issues
   🔀 list_merge_requests - List merge requests
   🏗️  list_pipelines - List CI/CD pipelines
   ⚙️  list_jobs - List pipeline jobs
   ❌ check_latest_failed_jobs - Check failed jobs
   📝 list_latest_commits - List recent commits

Interrupt Ctrl+C, and add this to Cursor config as shown in next steps.

Running locally in a MCP client like cursor

To run this MCP server from cursor. Go to cursor settings -> Tools & integrations -> Add MCP server

{
  "mcpServers": {
      "gitlab-mcp-local": {
       "command": "<venv absolute path>/python",
       "args": ["<git clone dir path>/gitlab_mcp_server.py"],
       "env": {
        "MCP_GITLAB_TOKEN": "your-actual-token-here",
        "MCP_ALLOWED_REPOS": "list of comma separated repos or groups with wildcard",
        "GITLAB_URL": "https://gitlab.com"  ## <-this is optional var but if you want to explicitly set to some gitlab instance pass here
         },
       "trust": true
     }
  }
}

Method 2: Container build

git clone git@github.com:redhat-ai-tools/gitlab-mcp.git
cd gitlab-mcp
podman build -t gitlab-mcp-server:latest  .

This will create a local image named gitlab-mcp-server:latest that you can use to run the server.

Running with Podman or Docker

Example configuration for running with Podman:

{
  "mcpServers": {
    "gitlab-mcp-server": {
      "command": "podman",
      "args": [
        "run",
        "-i",
        "--rm",
        "--env", "MCP_GITLAB_URL",  ## <-- if this is not passed, it will fallback to default gitlab.com
        "--env", "MCP_GITLAB_TOKEN",
         "--env","MCP_ALLOWED_REPOS",
        "localhost/gitlab-mcp-server:latest"
      ],
    }
  }
}

redhat-ai-tools/gitlab-mcp

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages