gitlab

A plugin that implements GitLab operations including issue management, file handling, branch management, and snippet operations.

Configuration

The plugin requires the following configuration:

• GITLAB_TOKEN: (Required) Your GitLab personal access token
• GITLAB_URL: (Optional) Your GitLab instance URL. Defaults to https://gitlab.com/api/v4

Usage

{
  "plugins": [
    {
      "name": "gitlab",
      "path": "oci://ghcr.io/hyper-mcp-rs/gitlab-plugin:latest",
      "runtime_config": {
        "allowed_hosts": ["gitlab.com"], // Your GitLab host
        "env_vars": {
          "GITLAB_TOKEN": "your-gitlab-token",
          "GITLAB_URL": "https://gitlab.com/api/v4"  // Optional, defaults to GitLab.com
        }
      }
    }
  ]
}

Available Operations

Issues

• gl_create_issue: Create a new issue
• gl_get_issue: Get issue details
• gl_update_issue: Update an existing issue
• gl_add_issue_comment: Add a comment to an issue
• gl_list_issues: List issues for a project in GitLab. Supports filtering by state and labels.

Files

• gl_get_file_contents: Get file contents
• gl_create_or_update_file: Create or update a file
• gl_delete_file: Delete a file from the repository
• gl_push_files: Push multiple files

Branches and Merge Requests

• gl_create_branch: Create a new branch
• gl_list_branches: List all branches in a GitLab project
• gl_create_merge_request: Create a merge request
• gl_update_merge_request: Update an existing merge request in a GitLab project.
• gl_get_merge_request: Get details of a specific merge request in a GitLab project.

Snippets

• gl_create_snippet: Create a new snippet
• gl_update_snippet: Update an existing snippet
• gl_get_snippet: Get snippet details
• gl_delete_snippet: Delete a snippet

Repository

• gl_get_repo_tree: Get the list of files and directories in a project repository. Handles pagination internally.
• gl_get_repo_members: Get a list of members for a GitLab project. Supports fetching direct or inherited members and filtering by query. Handles pagination internally.