mcp-gitlab-jira

Instructions

Implementation Reference

• src/index.ts:1402-1428 (handler)

  Main handler for gitlab_list_releases_since_version tool. Resolves projectPath by fuzzy matching projectName, then calls service to filter releases since given version using semver comparison.

  case 'gitlab_list_releases_since_version': {
    if (!gitlabService) {
      throw new Error('GitLab service is not initialized.');
    }
    const { projectName, sinceVersion } = args as {
      projectName: string;
      sinceVersion: string;
    };
    const projects =
      await gitlabService.filterProjectsByName(projectName);
    if (projects.length === 0) {
      throw new Error(`No project found with name: ${projectName}`);
    }
    const projectPath = projects[0].path_with_namespace;
    const result = await gitlabService.filterReleasesSinceVersion(
      projectPath,
      sinceVersion,
    );
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
    };
  }

• src/index.ts:253-270 (registration)

  Tool registration in the allTools array, defining name, description, and inputSchema for gitlab_list_releases_since_version.

    name: 'gitlab_list_releases_since_version',
    description:
      'Filters releases for a given GitLab project since a specific version.',
    inputSchema: {
      type: 'object',
      properties: {
        projectName: {
          type: 'string',
          description: 'The name or partial name of the GitLab project.',
        },
        sinceVersion: {
          type: 'string',
          description: 'The version to filter releases since (e.g., "1.0.0").',
        },
      },
      required: ['projectName', 'sinceVersion'],
    },
  },

• src/gitlab.service.ts:453-470 (helper)

  Helper method in GitLabService that fetches all releases and filters those with tag_name >= sinceVersion using semver.gte.

  async filterReleasesSinceVersion(
    projectPath: string,
    sinceVersion: string,
  ): Promise<any[]> {
    const allReleases = await this.getReleases(projectPath);
    const semver = await import('semver');
  
    return allReleases.filter((release) => {
      try {
        return semver.gte(release.tag_name, sinceVersion);
      } catch (error) {
        console.error(
          `Could not parse version ${release.tag_name} or ${sinceVersion}: ${error}`,
        );
        return false;
      }
    });
  }

• src/gitlab.service.ts:433-444 (helper)

  Helper method in GitLabService to fuzzy match projects by name and return matching GitLabProject objects; used to resolve projectPath from projectName in the handler.

  async filterProjectsByName(projectName: string): Promise<GitLabProject[]> {
    const allProjects = await this.listProjects();
    const lowerCaseProjectName = projectName.toLowerCase();
  
    return allProjects.filter(
      (project) =>
        project.name.toLowerCase().includes(lowerCaseProjectName) ||
        project.name_with_namespace
          .toLowerCase()
          .includes(lowerCaseProjectName),
    );
  }

• src/gitlab.service.ts:447-450 (helper)

  Helper method in GitLabService to fetch all releases from GitLab API for a project; called by filterReleasesSinceVersion.

  async getReleases(projectPath: string): Promise<any[]> {
    const encodedProjectPath = encodeURIComponent(projectPath);
    return this.callGitLabApi<any[]>(`projects/${encodedProjectPath}/releases`);
  }