GitLab MCP Server (Patched)

A Model Context Protocol (MCP) server for GitLab, patched to fix JSON Schema compatibility issues with modern clients (like Claude Desktop and Cursor).

Why this fork?

The official @modelcontextprotocol/server-gitlab package generates JSON Schemas with type: ["object"], which is rejected by stricter MCP clients. This version includes a middleware layer that recursively fixes these schemas to type: "object" and handles other compatibility edge cases.

Installation

You can use this server directly with npx without installing it globally:

npx @mspony/gitlab-mcp-server-fix

Configuration

Add the following to your MCP client configuration (e.g., claude_desktop_config.json or mcp.json):

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@mspony/gitlab-mcp-server-fix"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "GITLAB_API_URL": "https://gitlab.com/api/v4" 
      }
    }
  }
}

Note: For self-hosted GitLab, update GITLAB_API_URL to your instance's API endpoint.

Features

• All original GitLab tools: create_issue, merge_request, push_files, etc.
• Schema Fix: Automatically corrects type: ["object"] to type: "object".
• Nullable Fix: Converts ["string", "null"] to type: "string", nullable: true.

License

MIT