trackmcp
Back to directory
chris-miaskowski

custom-gitlab-mcp-server

View on GitHub
1 stars JavaScriptServers & Infrastructure Updated Aug 7, 2025

Documentation

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:

bash
npm install

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

json
{
     "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 NameDescription
`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

Frequently asked questions

What is custom-gitlab-mcp-server?

custom-gitlab-mcp-server is a Model Context Protocol (MCP) server listed in the TrackMCP directory.

How do I install custom-gitlab-mcp-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is custom-gitlab-mcp-server open source?

Yes — it is hosted on GitHub at https://github.com/chris-miaskowski/custom-gitlab-mcp-server and has 1 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP