mcp-gitlab-jira

Instructions

Implementation Reference

• src/index.ts:1905-1919 (handler)

  MCP server request handler for the 'gitlab_create_branch' tool. Extracts arguments, calls GitLabService.createBranch, and returns success response.

  case 'gitlab_create_branch': {
    if (!gitlabService) {
      throw new Error('GitLab service is not initialized.');
    }
    const { projectPath, branchName, ref } = args as { projectPath: string; branchName: string; ref: string };
    const result = await gitlabService.createBranch(projectPath, branchName, ref);
    return {
      content: [
        {
          type: 'text',
          text: `Branch created successfully: ${JSON.stringify(result, null, 2)}`,
        },
      ],
    };
  }

• src/index.ts:770-790 (registration)

  Tool registration in allTools array, including name, description, and input schema.

    name: 'gitlab_create_branch',
    description: 'Creates a new branch in a GitLab project.',
    inputSchema: {
      type: 'object',
      properties: {
        projectPath: {
          type: 'string',
          description: 'The path of the GitLab project.',
        },
        branchName: {
          type: 'string',
          description: 'The name of the new branch.',
        },
        ref: {
          type: 'string',
          description: 'The branch or SHA to create the branch from.',
        },
      },
      required: ['projectPath', 'branchName', 'ref'],
    },
  },

• src/gitlab.service.ts:613-623 (helper)

  GitLabService.createBranch method: core logic that makes the POST API call to GitLab to create the branch.

  async createBranch(projectPath: string, branchName: string, ref: string): Promise<any> {
    const encodedProjectPath = encodeURIComponent(projectPath);
    return this.callGitLabApi<any>(
      `projects/${encodedProjectPath}/repository/branches`,
      'POST',
      {
        branch: branchName,
        ref: ref,
      },
    );
  }