GitLab MCP Server

Instructions

Implementation Reference

• src/handlers/cicd-handlers.ts:77-90 (handler)

  The main handler function for gitlab_trigger_pipeline tool. Validates inputs and calls context.ciCdManager.triggerPipeline to execute the pipeline trigger.

  export const triggerPipeline: ToolHandler = async (params, context) => {
    const { project_id, ref, token, variables } = params.arguments || {};
    if (!project_id || !ref || !token) {
      throw new McpError(ErrorCode.InvalidParams, 'project_id, ref, and token are required');
    }
    
    const data = await context.ciCdManager.triggerPipeline(
      project_id as string | number, 
      ref as string, 
      token as string, 
      variables as Record<string, string> | undefined
    );
    return formatResponse(data);
  };

• src/utils/tools-data.ts:580-605 (schema)

  Input schema definition for the gitlab_trigger_pipeline tool, specifying parameters and validation rules.

    name: 'gitlab_trigger_pipeline',
    description: 'Trigger a pipeline run',
    inputSchema: {
      type: 'object',
      properties: {
        project_id: {
          type: 'string',
          description: 'The ID or URL-encoded path of the project'
        },
        ref: {
          type: 'string',
          description: 'The branch or tag name to run the pipeline for'
        },
        token: {
          type: 'string',
          description: 'The trigger token'
        },
        variables: {
          type: 'object',
          description: 'Variables to pass to the pipeline',
          additionalProperties: { type: 'string' }
        }
      },
      required: ['project_id', 'ref', 'token']
    }
  },

• src/utils/tool-registry.ts:55-55 (registration)

  Registration of the gitlab_trigger_pipeline tool in the central toolRegistry, mapping it to cicdHandlers.triggerPipeline.

  gitlab_trigger_pipeline: cicdHandlers.triggerPipeline,