gitlab-mcp-swift

GitLab MCP Server (Swift)

A Model Context Protocol (MCP) server that wraps the GitLab CLI (glab) to provide GitLab functionality to AI assistants like Claude Desktop.

Features

• 🚀 Native Swift implementation using the official MCP Swift SDK
• 🔧 Full GitLab CLI integration - supports all glab commands
• 🎯 Smart prompts for common workflows (merge requests, CI/CD, daily standup)
• 📊 JSON output parsing with fallback to plain text
• 🔐 Secure authentication via system glab credentials
• ⚡ High performance with Swift's async/await concurrency

Prerequisites

• macOS (Swift 5.9+ installed via Xcode)
• glab CLI installed and authenticated
• Claude Desktop or another MCP-compatible client

Installation

Quick Install

# Clone the repository
git clone https://github.com/yourusername/gitlab-mcp-swift.git
cd gitlab-mcp-swift

# Run the install script
./install.sh

The install script will:

1. Build the server using Swift Package Manager
2. Install it to ~/.swiftpm/bin/git-lab-mcp
3. Display the configuration for Claude Desktop

Manual Installation

# Build the project
swift build -c release

# Install to a location in your PATH
cp .build/release/git-lab-mcp ~/.swiftpm/bin/

Configuration

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "gitlab": {
      "command": "/Users/YOUR_USERNAME/.swiftpm/bin/git-lab-mcp",
      "args": ["--log-level", "info"],
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

Authentication

The server uses your existing glab CLI authentication:

# Login to GitLab
glab auth login

# Check authentication status
glab auth status

Available Tools

Core Tools

• glab_mr - Merge request operations (list, create, view, merge, approve)
• glab_issue - Issue management (list, create, view, close, update)
• glab_ci - CI/CD pipeline operations (view, list, run, retry)
• glab_repo - Repository operations (clone, fork, view, archive)
• glab_api - Direct GitLab API access
• glab_auth - Authentication management
• glab_version - Version information
• glab_raw - Execute any glab command directly

Prompts

The server includes intelligent prompts for common workflows:

• my-mrs - Check your merge requests
• create-mr - Create a merge request with guided parameters
• daily-standup - Gather GitLab activity for daily standups
• review-pipeline - Review CI/CD pipeline status

Usage Examples

Check Your Merge Requests

Use the prompt "my-mrs" to see all your open merge requests

Create a Merge Request

Use the prompt "create-mr" with:
- title: "Fix: Memory leak in user service"
- source_branch: "fix/memory-leak"
- target_branch: "main"

Run CI/CD Pipeline

Use tool "glab_ci" with:
- subcommand: "run"
- repo: "myteam/myproject"

Development

Building from Source

# Clone the repository
git clone https://github.com/yourusername/gitlab-mcp-swift.git
cd gitlab-mcp-swift

# Build in debug mode
swift build

# Run tests
swift test

# Build for release
swift build -c release

Project Structure

gitlab-mcp-swift/
├── Sources/
│   └── GitLabMCP/
│       ├── GitLabMCPServer.swift    # Main server implementation
│       ├── GitLabMCPCommand.swift   # CLI entry point
│       └── GitLabCLI.swift          # GitLab CLI wrapper
├── Package.swift                     # Swift package manifest
├── install.sh                        # Installation script
└── README.md                         # This file

Troubleshooting

Server fails to start

• Ensure glab is installed: which glab
• Check authentication: glab auth status
• Run with debug logging: --log-level debug

Commands return "not authenticated"

• Run glab auth login to authenticate
• For self-hosted instances: glab auth login --hostname your.gitlab.instance

MCP connection issues

• Restart Claude Desktop after configuration changes
• Check the logs in Claude Desktop's developer console
• Verify the executable path is correct in the configuration

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

MIT License - see LICENSE file for details

Acknowledgments

• Built with the Model Context Protocol Swift SDK
• Wraps the excellent GitLab CLI (glab)
• Inspired by the need for better GitLab integration in AI assistants