Custom GitLab MCP Server

Custom GitLab MCP Server

A custom implementation of the GitLab MCP (Model Context Protocol) server for integration with Claude and other MCP-compliant AI assistants.

Overview

This MCP server provides seamless integration with GitLab repositories, allowing AI assistants to:

• Search GitLab repositories
• Fetch file contents
• Create or update files
• Push multiple files in a single commit
• Create issues and merge requests
• Fork repositories
• Create branches

Fixed Implementation

This custom implementation fixes issues with schema validation that were present in the standard GitLab MCP server implementation, specifically for the search_repositories tool.

Installation

1. Clone this repository
2. Install dependencies:

   npm install
   

3. Configure in your Claude settings file or Claude Desktop config file:

   {
     "mcpServers": {
       "github.com/modelcontextprotocol/servers/tree/main/src/gitlab": {
         "command": "node",
         "args": [
           "/path/to/custom-gitlab-server/index.js"
         ],
         "env": {
           "GITLAB_PERSONAL_ACCESS_TOKEN": "your-gitlab-token",
           "GITLAB_API_URL": "https://your-gitlab-instance/api/v4"
         }
       }
     }
   }
   

Prerequisites

• Node.js (v14 or higher)
• GitLab Personal Access Token with appropriate scopes:
  • api for full API access
  • read_api for read-only access
  • read_repository and write_repository for repository operations

Available Tools

| Tool Name | Description | |-----------|-------------| | search_repositories | Search for GitLab projects | | get_file_contents | Get contents of a file or directory | | create_or_update_file | Create or update a single file | | push_files | Push multiple files in a single commit | | create_repository | Create a new GitLab project | | create_issue | Create a new issue | | create_merge_request | Create a new merge request | | fork_repository | Fork a project | | create_branch | Create a new branch |

License

MIT