gitlab-mcp-server

Instructions

Implementation Reference

• src/gitlab-api.ts:1366-1405 (handler)

  Core handler function that lists project members (including inherited) via GitLab API /projects/{projectId}/members/all endpoint. Supports query, pagination params. Parses response with GitLabMembersResponseSchema.

  async listProjectMembers(
    projectId: string,
    options: {
      query?: string;
      page?: number;
      per_page?: number;
    } = {}
  ): Promise<GitLabMembersResponse> {
    const url = new URL(
      `${this.apiUrl}/projects/${encodeURIComponent(projectId)}/members/all`
    );
  
    // Add query parameters
    Object.entries(options).forEach(([key, value]) => {
      if (value !== undefined) {
        url.searchParams.append(key, value.toString());
      }
    });
  
    const response = await fetch(url.toString(), {
      headers: {
        "Authorization": `Bearer ${this.token}`
      }
    });
  
    if (!response.ok) {
      throw new McpError(
        ErrorCode.InternalError,
        `GitLab API error: ${response.statusText}`
      );
    }
  
    const data = await response.json();
    const totalCount = parseInt(response.headers.get("X-Total") || "0");
  
    return GitLabMembersResponseSchema.parse({
      count: totalCount,
      items: data
    });
  }

• src/schemas.ts:599-604 (schema)

  Input schema (Zod) for list_project_members tool defining required project_id and optional query/page/per_page params.

  export const ListProjectMembersSchema = z.object({
    project_id: z.string(),
    query: z.string().optional(),
    page: z.number().optional(),
    per_page: z.number().optional(),
  });

• src/index.ts:268-272 (registration)

  Tool registration in ALL_TOOLS array: defines name, description, inputSchema (from ListProjectMembersSchema), readOnly flag.

    name: "list_project_members",
    description: "List all members of a GitLab project (including inherited members)",
    inputSchema: createJsonSchema(ListProjectMembersSchema),
    readOnly: true
  },

• src/index.ts:673-678 (handler)

  MCP server switch-case dispatcher: parses args with schema, extracts params, calls gitlabApi.listProjectMembers, returns formatted response.

  case "list_project_members": {
    const args = ListProjectMembersSchema.parse(request.params.arguments);
    const { project_id, ...options } = args;
    const members = await gitlabApi.listProjectMembers(project_id, options);
    return formatMembersResponse(members);
  }

• src/schemas.ts:628-633 (schema)

  Output response schema (Zod) for members list: count and array of GitLabMember objects.

  export const GitLabMembersResponseSchema = z.object({
    count: z.number(),
    items: z.array(GitLabMemberSchema)
  });
  
  export type GitLabMembersResponse = z.infer<typeof GitLabMembersResponseSchema>;