gitlab-mcp-server

Instructions

Implementation Reference

• src/index.ts:325-329 (handler)

  Handler for the fork_repository tool that parses input arguments using the schema, delegates to GitLabApi.forkProject helper, and formats the response as JSON text.

  case "fork_repository": {
    const args = ForkRepositorySchema.parse(request.params.arguments);
    const fork = await gitlabApi.forkProject(args.project_id, args.namespace);
    return { content: [{ type: "text", text: JSON.stringify(fork, null, 2) }] };
  }

• src/schemas.ts:430-433 (schema)

  Zod schema defining the input structure for the fork_repository tool: project_id (required string) and optional namespace.

  export const ForkRepositorySchema = z.object({
    project_id: z.string(),
    namespace: z.string().optional()
  });

• src/index.ts:150-154 (registration)

  Tool registration in the ALL_TOOLS array, specifying name, description, input schema conversion, and readOnly flag.

  {
    name: "fork_repository",
    description: "Fork a GitLab project to your account or specified namespace",
    inputSchema: createJsonSchema(ForkRepositorySchema),
    readOnly: false

• src/gitlab-api.ts:86-109 (helper)

  Implementation of forkProject method in GitLabApi class that makes the POST request to GitLab's /projects/{id}/fork endpoint, handles response, and validates with GitLabForkSchema.

  async forkProject(
    projectId: string,
    namespace?: string
  ): Promise<GitLabFork> {
    const url = `${this.apiUrl}/projects/${encodeURIComponent(projectId)}/fork`;
    const queryParams = namespace ? `?namespace=${encodeURIComponent(namespace)}` : '';
  
    const response = await fetch(url + queryParams, {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${this.token}`,
        "Content-Type": "application/json"
      }
    });
  
    if (!response.ok) {
      throw new McpError(
        ErrorCode.InternalError,
        `GitLab API error: ${response.statusText}`
      );
    }
  
    return GitLabForkSchema.parse(await response.json());
  }