GitLab MCP Server

Instructions

Implementation Reference

• src/handlers/issues.ts:35-46 (handler)

  The main handler function that fetches the issue details from GitLab API and returns formatted response.

  async getIssue(args: GetIssueParams) {
    const data = await this.client.get(`/projects/${encodeURIComponent(args.project_id)}/issues/${args.issue_iid}`);
    
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(data, null, 2),
        },
      ],
    };
  }

• src/server.ts:167-170 (registration)

  Switch case registration that dispatches tool calls to the issueHandlers.getIssue method.

  case "get_issue":
    return await this.issueHandlers.getIssue(
      args as unknown as GetIssueParams
    );

• src/tools/issues.ts:52-68 (schema)

  MCP tool definition including name, description, and input schema for validation.

    name: 'get_issue',
    description: 'Get details of a specific issue',
    inputSchema: {
      type: 'object',
      properties: {
        project_id: {
          type: 'string',
          description: 'Project ID or path',
        },
        issue_iid: {
          type: 'number',
          description: 'Issue internal ID',
        },
      },
      required: ['project_id', 'issue_iid'],
    },
  },

• src/types.ts:226-229 (schema)

  TypeScript interface defining the parameters for the get_issue tool.

  export interface GetIssueParams {
    project_id: string;
    issue_iid: number;
  }