mcp-gitlab-jira

Instructions

Implementation Reference

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

  The main handler function that implements the tool logic: fetches all accessible projects and filters them by the given projectName using case-insensitive partial matching on name or full namespace path.
  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/index.ts:1355-1369 (registration)

  Registration of the tool handler in the MCP server's CallToolRequest handler switch statement. Extracts projectName from args and calls the service method.
  case 'gitlab_list_projects_by_name': { if (!gitlabService) { throw new Error('GitLab service is not initialized.'); } const { projectName } = args as { projectName: string }; const result = await gitlabService.filterProjectsByName(projectName); return { content: [ { type: 'text', text: JSON.stringify(result, null, 2), }, ], }; }
• src/index.ts:214-226 (schema)

  Tool definition including name, description, and input schema requiring 'projectName' string.
  name: 'gitlab_list_projects_by_name', description: 'Filters GitLab projects by name using a fuzzy, case-insensitive match.', inputSchema: { type: 'object', properties: { projectName: { type: 'string', description: 'The name or partial name of the project to filter by.', }, }, required: ['projectName'], },
• src/gitlab.service.ts:347-375 (helper)

  Helper method that fetches and caches the list of all accessible GitLab projects (with membership and min access level 30), used by filterProjectsByName.
  async listProjects(): Promise<GitLabProject[]> { if ( this.projectCache && Date.now() - this.projectCache.timestamp < this.CACHE_DURATION_MS ) { return this.projectCache.data; } const url = `projects?membership=true&min_access_level=30&order_by=last_activity_at&sort=desc&per_page=100`; const projects = await this.callGitLabApi<any[]>(url); const simplifiedProjects: GitLabProject[] = projects.map((project) => ({ id: project.id, name: project.name, name_with_namespace: project.name_with_namespace, path_with_namespace: project.path_with_namespace, last_activity_at: project.last_activity_at, ssh_url_to_repo: project.ssh_url_to_repo, http_url_to_repo: project.http_url_to_repo, web_url: project.web_url, readme_url: project.readme_url, issue_branch_template: project.issue_branch_template, statistics: project.statistics, _links: project._links, })); this.projectCache = { data: simplifiedProjects, timestamp: Date.now() }; return simplifiedProjects; }
• src/gitlab.ts:121-128 (schema)

  Type definition for GitLabProject, used as return type for the handler and helper.
  export interface GitLabProject { id: number; name: string; name_with_namespace: string; path_with_namespace: string; last_activity_at: string; }