Installation Options¶

# Clone the repository
git clone https://github.com/your-username/dev-mcp-gitlab.git
cd dev-mcp-gitlab

# Configure environment
cp .env.example .env
# Edit .env with your GitLab credentials

# Start services
docker-compose up -d

docker run -d \
  --name gitlab-mcp \
  -p 3000:3000 \
  -e GITLAB_URL=https://gitlab.example.com \
  -e GITLAB_TOKEN=your-token-here \
  iwakitakuma/gitlab-mcp:latest

# Install globally
npm install -g @modelcontextprotocol/server-gitlab

# Or install locally
npm install @modelcontextprotocol/server-gitlab

# Configure and run
export GITLAB_URL=https://gitlab.example.com
export GITLAB_TOKEN=your-token-here
mcp-server-gitlab

# Add the repository
helm repo add mcp-gitlab https://charts.example.com/mcp-gitlab
helm repo update

# Install
helm install mcp-gitlab mcp-gitlab/mcp-gitlab-server \
  --set gitlab.url=https://gitlab.example.com \
  --set gitlab.token=your-token-here

apiVersion: apps/v1
kind: Deployment
metadata:
  name: mcp-gitlab
spec:
  replicas: 2
  selector:
    matchLabels:
      app: mcp-gitlab
  template:
    metadata:
      labels:
        app: mcp-gitlab
    spec:
      containers:
      - name: mcp-gitlab
        image: iwakitakuma/gitlab-mcp:latest
        ports:
        - containerPort: 3000
        env:
        - name: GITLAB_URL
          value: "https://gitlab.example.com"
        - name: GITLAB_TOKEN
          valueFrom:
            secretKeyRef:
              name: gitlab-credentials
              key: token

{
  "family": "mcp-gitlab",
  "taskRoleArn": "arn:aws:iam::account:role/ecsTaskRole",
  "containerDefinitions": [
    {
      "name": "mcp-gitlab",
      "image": "iwakitakuma/gitlab-mcp:latest",
      "portMappings": [
        {
          "containerPort": 3000,
          "protocol": "tcp"
        }
      ],
      "environment": [
        {
          "name": "GITLAB_URL",
          "value": "https://gitlab.example.com"
        }
      ],
      "secrets": [
        {
          "name": "GITLAB_TOKEN",
          "valueFrom": "arn:aws:secretsmanager:region:account:secret:gitlab-token"
        }
      ]
    }
  ]
}

gcloud run deploy mcp-gitlab \
  --image=iwakitakuma/gitlab-mcp:latest \
  --platform=managed \
  --region=us-central1 \
  --set-env-vars="GITLAB_URL=https://gitlab.example.com" \
  --set-secrets="GITLAB_TOKEN=gitlab-token:latest"

az container create \
  --resource-group myResourceGroup \
  --name mcp-gitlab \
  --image iwakitakuma/gitlab-mcp:latest \
  --ports 3000 \
  --environment-variables GITLAB_URL=https://gitlab.example.com \
  --secure-environment-variables GITLAB_TOKEN=your-token-here

# Clone the repository
git clone https://github.com/your-username/dev-mcp-gitlab.git
cd dev-mcp-gitlab

# Install dependencies
npm install

# Set up environment
cp .env.example .env
# Edit .env file

# Run in development mode
npm run dev

# With VS Code Dev Containers
code --install-extension ms-vscode-remote.remote-containers
# Open in container when prompted

# Or with Docker directly
docker build -t mcp-gitlab-dev -f Dockerfile.dev .
docker run -it --rm -v $(pwd):/workspace mcp-gitlab-dev

gitlab:
  url: https://gitlab.example.com
  token: your-token-here

server:
  port: 3000
  host: 0.0.0.0

logging:
  level: info
  format: json

features:
  caching: true
  webhooks: true
  analytics: false

# Check server status
curl http://localhost:3000/health

# Expected response
{
  "status": "healthy",
  "version": "1.0.0",
  "gitlab": {
    "connected": true,
    "version": "16.5.0"
  }
}

# Test MCP connection
echo '{"jsonrpc":"2.0","id":1,"method":"ping","params":{}}' | \
  curl -X POST -H "Content-Type: application/json" \
  -d @- http://localhost:3000/mcp

# View container logs
docker logs gitlab-mcp

# Enable debug logging
export LOG_LEVEL=debug

# Check system resources
docker stats gitlab-mcp