gitlab-mcp-server

Instructions

Implementation Reference

• src/index.ts:401-405 (handler)

  MCP tool handler in the switch statement that parses arguments, extracts project_id and options, calls gitlabApi.createIssue, and returns the JSON response.

  case "create_issue": {
    const args = CreateIssueSchema.parse(request.params.arguments);
    const { project_id, ...options } = args;
    const issue = await gitlabApi.createIssue(project_id, options);
    return { content: [{ type: "text", text: JSON.stringify(issue, null, 2) }] };

• src/schemas.ts:422-424 (schema)

  Zod schema for create_issue tool input: requires project_id and merges CreateIssueOptionsSchema (title, description, etc.). CreateIssueOptionsSchema defined lines 374-380.

  export const CreateIssueSchema = z.object({
    project_id: z.string()
  }).merge(CreateIssueOptionsSchema);

• src/index.ts:138-142 (registration)

  Tool registration in ALL_TOOLS array, defining name, description, input schema, and readOnly flag.

  {
    name: "create_issue",
    description: "Create a new issue in a GitLab project",
    inputSchema: createJsonSchema(CreateIssueSchema),
    readOnly: false

• src/gitlab-api.ts:688-718 (helper)

  GitLab API helper method that performs the POST request to create an issue, handles response and validation.

  async createIssue(
    projectId: string,
    options: z.infer<typeof CreateIssueOptionsSchema>
  ): Promise<GitLabIssue> {
    const response = await fetch(
      `${this.apiUrl}/projects/${encodeURIComponent(projectId)}/issues`,
      {
        method: "POST",
        headers: {
          "Authorization": `Bearer ${this.token}`,
          "Content-Type": "application/json"
        },
        body: JSON.stringify({
          title: options.title,
          description: options.description,
          assignee_ids: options.assignee_ids,
          milestone_id: options.milestone_id,
          labels: options.labels?.join(',')
        })
      }
    );
  
    if (!response.ok) {
      throw new McpError(
        ErrorCode.InternalError,
        `GitLab API error: ${response.statusText}`
      );
    }
  
    return GitLabIssueSchema.parse(await response.json());
  }