GitLab MCP Server

HTTP-based Model Context Protocol (MCP) server for GitLab with HTTP header authentication.

Installation

Use install.bat or run manually:

python -m venv venv
.\venv\Scripts\activate.bat
pip install -r requirements.txt
pip install pip-system-certs

Running the Server

.\venv\Scripts\activate.bat
python run_server.py```n
Server will be at: http://127.0.0.1:8000/mcp

Configuration

Required headers:

Authorization: Bearer <gitlab-token>
X-GitLab-Server: https://gitlab.centrala.bzwbk/
Accept: application/json, text/event-stream

GitLab Token needs permissions:

• read_api - for reading issues, merge requests, and other API resources
• write_api - for creating issues and other write operations
• read_repository - for accessing repository content (files, commits, branches)
• read_user - for accessing user information
• api - full API access (alternative to read_api + write_api)
• read_registry - for container registry operations (optional)

Available Tools

• get_my_projects - Get list of user's projects
• get_user_info - Get current user information
• get_my_issues - Get issues assigned to user
• get_my_merge_requests - Get user's merge requests
• search_projects - Search projects by name
• get_project_info - Get project details
• get_project_files - List project files and directories
• get_file_content - Get file content
• get_project_commits - Get recent commits from a branch
• create_issue - Create new issue
• get_project_merge_requests - Get MRs for specific project
• get_project_issues - Get issues for specific project
• get_project_pipelines - Get project pipelines (CI/CD)
• search_files_in_project - Search files by name
• get_project_branches - List all project branches
• get_commit_details - Get detailed commit information
• get_commit_diff - Get changes in a specific commit
• compare_branches - Compare two branches
• get_file_history - Get commit history for a file

Docker

See DOCKER.md for Docker instructions.