@ekho/gitlab-mcp 1.1.0

package/dist/http/rest.js

@@ -0,0 +1,369 @@
+import { writeFile } from 'node:fs/promises';
+import { FormData, request } from 'undici';
+import { authHeader } from '../config.js';
+import { GitLabApiError, summarizeBody } from './errors.js';
+export class RestClient {
+    cfg;
+    dispatcher;
+    constructor(cfg, dispatcher) {
+        this.cfg = cfg;
+        this.dispatcher = dispatcher;
+    }
+    async request(opts) {
+        const method = opts.method ?? 'GET';
+        const url = this.buildUrl(opts.path, opts.query);
+        const maxRetries = opts.maxRetries ?? this.cfg.maxRetries;
+        let attempt = 0;
+        let lastError;
+        while (attempt <= maxRetries) {
+            try {
+                return await this.execute(method, url, opts);
+            }
+            catch (err) {
+                lastError = err;
+                if (!(err instanceof GitLabApiError) || !err.isRetryable || attempt === maxRetries) {
+                    if (opts.nullOn404 && err instanceof GitLabApiError && err.status === 404) {
+                        return {
+                            data: null,
+                            status: 404,
+                            headers: {},
+                            links: {},
+                            pagination: emptyPagination(),
+                        };
+                    }
+                    throw err;
+                }
+                const delay = this.backoffDelay(attempt, err);
+                await sleep(delay);
+                attempt += 1;
+            }
+        }
+        throw lastError instanceof Error ? lastError : new Error('REST request failed');
+    }
+    async execute(method, url, opts) {
+        const headers = {
+            Accept: 'application/json',
+            'User-Agent': this.cfg.userAgent,
+            ...authHeader(this.cfg),
+            ...(opts.headers ?? {}),
+        };
+        let body;
+        if (opts.body !== undefined && opts.body !== null) {
+            body = JSON.stringify(opts.body);
+            headers['Content-Type'] = 'application/json';
+        }
+        const res = await request(url, {
+            method,
+            headers,
+            signal: AbortSignal.timeout(this.cfg.requestTimeoutMs),
+            ...(body !== undefined ? { body } : {}),
+            ...(this.dispatcher ? { dispatcher: this.dispatcher } : {}),
+        });
+        const responseHeaders = flattenHeaders(res.headers);
+        const text = await res.body.text();
+        const parsed = parseBody(text, responseHeaders['content-type']);
+        if (res.statusCode >= 400) {
+            const requestId = responseHeaders['x-request-id'];
+            throw new GitLabApiError({
+                message: `GitLab ${method} ${url} → ${res.statusCode}: ${summarizeBody(parsed)}`,
+                status: res.statusCode,
+                method,
+                url,
+                ...(requestId ? { requestId } : {}),
+                body: parsed,
+            });
+        }
+        return {
+            data: parsed,
+            status: res.statusCode,
+            headers: responseHeaders,
+            links: parseLinkHeader(responseHeaders['link']),
+            pagination: parsePagination(responseHeaders),
+        };
+    }
+    async requestMultipart(opts) {
+        const method = opts.method ?? 'POST';
+        const url = this.buildUrl(opts.path, opts.query);
+        const maxRetries = opts.maxRetries ?? this.cfg.maxRetries;
+        let attempt = 0;
+        let lastError;
+        while (attempt <= maxRetries) {
+            try {
+                const form = buildFormData(opts.fields);
+                return await this.executeRaw(method, url, opts.headers, form, 'json');
+            }
+            catch (err) {
+                lastError = err;
+                if (!(err instanceof GitLabApiError) || !err.isRetryable || attempt === maxRetries) {
+                    throw err;
+                }
+                await sleep(this.backoffDelay(attempt, err));
+                attempt += 1;
+            }
+        }
+        throw lastError instanceof Error ? lastError : new Error('multipart request failed');
+    }
+    async uploadBinary(opts) {
+        const method = opts.method ?? 'PUT';
+        const url = this.buildUrl(opts.path, opts.query);
+        const maxRetries = opts.maxRetries ?? this.cfg.maxRetries;
+        let attempt = 0;
+        let lastError;
+        while (attempt <= maxRetries) {
+            try {
+                const headers = {
+                    Accept: 'application/json',
+                    'User-Agent': this.cfg.userAgent,
+                    'Content-Type': opts.contentType,
+                    ...authHeader(this.cfg),
+                    ...(opts.headers ?? {}),
+                };
+                const res = await request(url, {
+                    method,
+                    headers,
+                    body: Buffer.from(opts.body),
+                    signal: AbortSignal.timeout(this.cfg.requestTimeoutMs),
+                    ...(this.dispatcher ? { dispatcher: this.dispatcher } : {}),
+                });
+                const responseHeaders = flattenHeaders(res.headers);
+                const text = await res.body.text();
+                const parsed = parseBody(text, responseHeaders['content-type']);
+                if (res.statusCode >= 400) {
+                    throw new GitLabApiError({
+                        message: `GitLab ${method} ${url} → ${res.statusCode}: ${summarizeBody(parsed)}`,
+                        status: res.statusCode,
+                        method,
+                        url,
+                        body: parsed,
+                    });
+                }
+                return {
+                    data: parsed,
+                    status: res.statusCode,
+                    headers: responseHeaders,
+                    links: parseLinkHeader(responseHeaders['link']),
+                    pagination: parsePagination(responseHeaders),
+                };
+            }
+            catch (err) {
+                lastError = err;
+                if (!(err instanceof GitLabApiError) || !err.isRetryable || attempt === maxRetries) {
+                    throw err;
+                }
+                await sleep(this.backoffDelay(attempt, err));
+                attempt += 1;
+            }
+        }
+        throw lastError instanceof Error ? lastError : new Error('binary upload failed');
+    }
+    async downloadBinary(opts) {
+        const url = this.buildUrl(opts.path, opts.query);
+        const maxRetries = opts.maxRetries ?? this.cfg.maxRetries;
+        const maxInline = opts.maxInlineBytes ?? 1024 * 1024;
+        let attempt = 0;
+        let lastError;
+        while (attempt <= maxRetries) {
+            try {
+                const headers = {
+                    'User-Agent': this.cfg.userAgent,
+                    ...authHeader(this.cfg),
+                    ...(opts.headers ?? {}),
+                };
+                const res = await request(url, {
+                    method: 'GET',
+                    headers,
+                    signal: AbortSignal.timeout(this.cfg.requestTimeoutMs),
+                    ...(this.dispatcher ? { dispatcher: this.dispatcher } : {}),
+                });
+                const responseHeaders = flattenHeaders(res.headers);
+                if (res.statusCode >= 400) {
+                    const text = await res.body.text();
+                    const parsed = parseBody(text, responseHeaders['content-type']);
+                    throw new GitLabApiError({
+                        message: `GitLab GET ${url} → ${res.statusCode}: ${summarizeBody(parsed)}`,
+                        status: res.statusCode,
+                        method: 'GET',
+                        url,
+                        body: parsed,
+                    });
+                }
+                const buf = Buffer.from(await res.body.arrayBuffer());
+                const contentType = responseHeaders['content-type'];
+                if (opts.saveTo) {
+                    await writeFile(opts.saveTo, buf);
+                    return {
+                        status: res.statusCode,
+                        size: buf.length,
+                        content_type: contentType,
+                        saved_to: opts.saveTo,
+                    };
+                }
+                if (buf.length > maxInline) {
+                    return {
+                        status: res.statusCode,
+                        size: buf.length,
+                        content_type: contentType,
+                        content_base64: buf.subarray(0, maxInline).toString('base64'),
+                        truncated: true,
+                    };
+                }
+                return {
+                    status: res.statusCode,
+                    size: buf.length,
+                    content_type: contentType,
+                    content_base64: buf.toString('base64'),
+                };
+            }
+            catch (err) {
+                lastError = err;
+                if (!(err instanceof GitLabApiError) || !err.isRetryable || attempt === maxRetries) {
+                    throw err;
+                }
+                await sleep(this.backoffDelay(attempt, err));
+                attempt += 1;
+            }
+        }
+        throw lastError instanceof Error ? lastError : new Error('binary download failed');
+    }
+    async executeRaw(method, url, extraHeaders, body, parseAs) {
+        const headers = {
+            Accept: 'application/json',
+            'User-Agent': this.cfg.userAgent,
+            ...authHeader(this.cfg),
+            ...(extraHeaders ?? {}),
+        };
+        // For FormData, let undici set Content-Type with the boundary.
+        const res = await request(url, {
+            method,
+            headers,
+            body,
+            signal: AbortSignal.timeout(this.cfg.requestTimeoutMs),
+            ...(this.dispatcher ? { dispatcher: this.dispatcher } : {}),
+        });
+        const responseHeaders = flattenHeaders(res.headers);
+        const text = await res.body.text();
+        const parsed = parseAs === 'json' ? parseBody(text, responseHeaders['content-type']) : text;
+        if (res.statusCode >= 400) {
+            const requestId = responseHeaders['x-request-id'];
+            throw new GitLabApiError({
+                message: `GitLab ${method} ${url} → ${res.statusCode}: ${summarizeBody(parsed)}`,
+                status: res.statusCode,
+                method,
+                url,
+                ...(requestId ? { requestId } : {}),
+                body: parsed,
+            });
+        }
+        return {
+            data: parsed,
+            status: res.statusCode,
+            headers: responseHeaders,
+            links: parseLinkHeader(responseHeaders['link']),
+            pagination: parsePagination(responseHeaders),
+        };
+    }
+    buildUrl(path, query) {
+        const base = this.cfg.baseUrl.replace(/\/$/, '');
+        const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+        const url = new URL(`${base}/api/v4${normalizedPath}`);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value === undefined || value === null)
+                    continue;
+                if (Array.isArray(value)) {
+                    for (const v of value)
+                        url.searchParams.append(`${key}[]`, String(v));
+                }
+                else {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    backoffDelay(attempt, err) {
+        if (err.status === 429) {
+            // Respect Retry-After if present in body context — undici doesn't expose
+            // headers on the error directly, so fall back to exponential.
+        }
+        const base = 250;
+        const jitter = Math.random() * 100;
+        return Math.min(base * 2 ** attempt + jitter, 10_000);
+    }
+}
+function flattenHeaders(headers) {
+    const out = {};
+    for (const [k, v] of Object.entries(headers)) {
+        if (v === undefined)
+            continue;
+        out[k.toLowerCase()] = Array.isArray(v) ? v.join(', ') : v;
+    }
+    return out;
+}
+function parseBody(text, contentType) {
+    if (!text)
+        return null;
+    if (contentType && contentType.includes('application/json')) {
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    return text;
+}
+export function parseLinkHeader(header) {
+    if (!header)
+        return {};
+    const out = {};
+    for (const part of header.split(',')) {
+        const match = /<([^>]+)>;\s*rel="([^"]+)"/.exec(part.trim());
+        if (match && match[1] && match[2])
+            out[match[2]] = match[1];
+    }
+    return out;
+}
+function parsePagination(headers) {
+    const num = (v) => v === undefined || v === '' ? undefined : Number(v);
+    return {
+        page: num(headers['x-page']),
+        perPage: num(headers['x-per-page']),
+        total: num(headers['x-total']),
+        totalPages: num(headers['x-total-pages']),
+        nextPage: num(headers['x-next-page']),
+        prevPage: num(headers['x-prev-page']),
+    };
+}
+function emptyPagination() {
+    return {
+        page: undefined,
+        perPage: undefined,
+        total: undefined,
+        totalPages: undefined,
+        nextPage: undefined,
+        prevPage: undefined,
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function buildFormData(fields) {
+    const form = new FormData();
+    for (const f of fields) {
+        if (f.fileName !== undefined) {
+            const bytes = f.contentBase64 !== undefined
+                ? Buffer.from(f.contentBase64, 'base64')
+                : Buffer.from(f.contentText ?? '', 'utf8');
+            const blob = new Blob([new Uint8Array(bytes)], {
+                type: f.contentType ?? 'application/octet-stream',
+            });
+            form.append(f.name, blob, f.fileName);
+        }
+        else {
+            form.append(f.name, f.value ?? '');
+        }
+    }
+    return form;
+}
+//# sourceMappingURL=rest.js.map

package/dist/http/rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.js","sourceRoot":"","sources":["../../src/http/rest.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadConfig } from './config.js';
+import { RestClient } from './http/rest.js';
+import { GraphQLClient } from './http/graphql.js';
+import { registerAllTools } from './tools/registry.js';
+async function main() {
+    const config = loadConfig();
+    const rest = new RestClient(config);
+    const graphql = new GraphQLClient(config);
+    const server = new McpServer({
+        name: 'gitlab-mcp',
+        version: '0.0.1',
+    });
+    registerAllTools(server, { config, rest, graphql });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    const msg = err instanceof Error ? err.stack ?? err.message : String(err);
+    process.stderr.write(`gitlab-mcp failed to start:\n${msg}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,gBAAgB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,GAAG,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/shared/args.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+/** Numeric id or full path string. Used wherever GitLab accepts both. */
+export declare const IdOrPath: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
+/** Common pagination args for REST list endpoints. */
+export declare const PaginationArgs: {
+    page: z.ZodOptional<z.ZodNumber>;
+    per_page: z.ZodOptional<z.ZodNumber>;
+};
+/** project_id is optional — falls back to GITLAB_DEFAULT_PROJECT. */
+export declare const ProjectIdArg: {
+    project_id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+};
+/** group_id is optional — falls back to GITLAB_DEFAULT_GROUP. */
+export declare const GroupIdArg: {
+    group_id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+};
+/** Discriminator for endpoints that exist on both project and group. */
+export declare const ScopeArg: {
+    scope: z.ZodEnum<["project", "group"]>;
+    scope_id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+};
+export declare const TargetTypeArg: z.ZodEnum<["issue", "merge_request", "commit"]>;
+/** Diff position for inline MR discussion notes. */
+export declare const DiffPositionSchema: z.ZodObject<{
+    base_sha: z.ZodString;
+    start_sha: z.ZodString;
+    head_sha: z.ZodString;
+    position_type: z.ZodDefault<z.ZodLiteral<"text">>;
+    new_path: z.ZodString;
+    old_path: z.ZodOptional<z.ZodString>;
+    new_line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    old_line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    base_sha: string;
+    start_sha: string;
+    head_sha: string;
+    position_type: "text";
+    new_path: string;
+    old_path?: string | undefined;
+    new_line?: number | null | undefined;
+    old_line?: number | null | undefined;
+}, {
+    base_sha: string;
+    start_sha: string;
+    head_sha: string;
+    new_path: string;
+    position_type?: "text" | undefined;
+    old_path?: string | undefined;
+    new_line?: number | null | undefined;
+    old_line?: number | null | undefined;
+}>;

package/dist/shared/args.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+/** Numeric id or full path string. Used wherever GitLab accepts both. */
+export const IdOrPath = z.union([z.string(), z.number()]);
+/** Common pagination args for REST list endpoints. */
+export const PaginationArgs = {
+    page: z.number().int().positive().optional().describe('Page number (default 1).'),
+    per_page: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe('Items per page, max 100 (default 20).'),
+};
+/** project_id is optional — falls back to GITLAB_DEFAULT_PROJECT. */
+export const ProjectIdArg = {
+    project_id: IdOrPath.optional().describe('Numeric id or full path (e.g. "group/sub/project"). Falls back to GITLAB_DEFAULT_PROJECT.'),
+};
+/** group_id is optional — falls back to GITLAB_DEFAULT_GROUP. */
+export const GroupIdArg = {
+    group_id: IdOrPath.optional().describe('Numeric id or full path. Falls back to GITLAB_DEFAULT_GROUP.'),
+};
+/** Discriminator for endpoints that exist on both project and group. */
+export const ScopeArg = {
+    scope: z.enum(['project', 'group']).describe('Which container the resource lives in.'),
+    scope_id: IdOrPath
+        .optional()
+        .describe('Project or group id/path. Falls back to GITLAB_DEFAULT_PROJECT/GROUP.'),
+};
+export const TargetTypeArg = z
+    .enum(['issue', 'merge_request', 'commit'])
+    .describe('Discussion target: issue, merge_request, or commit.');
+/** Diff position for inline MR discussion notes. */
+export const DiffPositionSchema = z
+    .object({
+    base_sha: z.string(),
+    start_sha: z.string(),
+    head_sha: z.string(),
+    position_type: z.literal('text').default('text'),
+    new_path: z.string(),
+    old_path: z.string().optional(),
+    new_line: z.number().int().nullable().optional(),
+    old_line: z.number().int().nullable().optional(),
+})
+    .describe('Inline diff position for MR comments.');
+//# sourceMappingURL=args.js.map

package/dist/shared/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/shared/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yEAAyE;AACzE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAE1D,sDAAsD;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACjF,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;CACrD,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACtC,2FAA2F,CAC5F;CACF,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACpC,8DAA8D,CAC/D;CACF,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACtF,QAAQ,EAAE,QAAQ;SACf,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;CACrF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,IAAI,CAAC,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;KAC1C,QAAQ,CAAC,qDAAqD,CAAC,CAAC;AAEnE,oDAAoD;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACjD,CAAC;KACD,QAAQ,CAAC,uCAAuC,CAAC,CAAC"}

package/dist/shared/handlers.d.ts

@@ -0,0 +1,6 @@
+import { type ToolResultContent } from '../tools/types.js';
+/**
+ * Wrap a handler body so any thrown error becomes a structured MCP error result
+ * with isError: true, and any returned value becomes a JSON-encoded text content.
+ */
+export declare function safe(fn: () => Promise<unknown>): Promise<ToolResultContent>;

package/dist/shared/handlers.js

@@ -0,0 +1,14 @@
+import { errorResult, jsonResult } from '../tools/types.js';
+/**
+ * Wrap a handler body so any thrown error becomes a structured MCP error result
+ * with isError: true, and any returned value becomes a JSON-encoded text content.
+ */
+export async function safe(fn) {
+    try {
+        return jsonResult(await fn());
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/shared/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/shared/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAA0B,MAAM,mBAAmB,CAAC;AAEpF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,EAA0B;IACnD,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/shared/ids.d.ts

@@ -0,0 +1,18 @@
+import type { Config } from '../config.js';
+/**
+ * GitLab REST identifiers accept either a numeric ID or a URL-encoded full path
+ * (e.g. `group/subgroup/project` → `group%2Fsubgroup%2Fproject`). This helper
+ * normalizes either form for safe interpolation into URL paths.
+ */
+export declare function encodeId(idOrPath: string | number): string;
+/** Resolve a project identifier, falling back to GITLAB_DEFAULT_PROJECT. */
+export declare function resolveProjectId(cfg: Config, projectId?: string | number): string;
+/** Resolve a group identifier, falling back to GITLAB_DEFAULT_GROUP. */
+export declare function resolveGroupId(cfg: Config, groupId?: string | number): string;
+/**
+ * GitLab GraphQL uses global IDs of the form `gid://gitlab/Project/123`. This
+ * builds one from a numeric id and a type name.
+ */
+export declare function toGlobalId(type: string, id: string | number): string;
+/** Build a GraphQL `fullPath` from either a numeric id (not supported) or path. */
+export declare function projectFullPath(projectId: string): string;

package/dist/shared/ids.js

@@ -0,0 +1,43 @@
+/**
+ * GitLab REST identifiers accept either a numeric ID or a URL-encoded full path
+ * (e.g. `group/subgroup/project` → `group%2Fsubgroup%2Fproject`). This helper
+ * normalizes either form for safe interpolation into URL paths.
+ */
+export function encodeId(idOrPath) {
+    if (typeof idOrPath === 'number')
+        return String(idOrPath);
+    if (/^\d+$/.test(idOrPath))
+        return idOrPath;
+    return encodeURIComponent(idOrPath);
+}
+/** Resolve a project identifier, falling back to GITLAB_DEFAULT_PROJECT. */
+export function resolveProjectId(cfg, projectId) {
+    const raw = projectId ?? cfg.defaultProject;
+    if (raw === undefined || raw === '') {
+        throw new Error('project_id is required (or set GITLAB_DEFAULT_PROJECT). Pass numeric id or full path like group/subgroup/project.');
+    }
+    return encodeId(raw);
+}
+/** Resolve a group identifier, falling back to GITLAB_DEFAULT_GROUP. */
+export function resolveGroupId(cfg, groupId) {
+    const raw = groupId ?? cfg.defaultGroup;
+    if (raw === undefined || raw === '') {
+        throw new Error('group_id is required (or set GITLAB_DEFAULT_GROUP). Pass numeric id or full path like group/subgroup.');
+    }
+    return encodeId(raw);
+}
+/**
+ * GitLab GraphQL uses global IDs of the form `gid://gitlab/Project/123`. This
+ * builds one from a numeric id and a type name.
+ */
+export function toGlobalId(type, id) {
+    return `gid://gitlab/${type}/${id}`;
+}
+/** Build a GraphQL `fullPath` from either a numeric id (not supported) or path. */
+export function projectFullPath(projectId) {
+    if (/^\d+$/.test(projectId)) {
+        throw new Error('GraphQL queries require a full path (group/subgroup/project), not a numeric id.');
+    }
+    return projectId.includes('%2F') ? decodeURIComponent(projectId) : projectId;
+}
+//# sourceMappingURL=ids.js.map

package/dist/shared/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/shared/ids.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAyB;IAChD,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,SAA2B;IACvE,MAAM,GAAG,GAAG,SAAS,IAAI,GAAG,CAAC,cAAc,CAAC;IAC5C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,mHAAmH,CACpH,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,OAAyB;IACnE,MAAM,GAAG,GAAG,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC;IACxC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,EAAmB;IAC1D,OAAO,gBAAgB,IAAI,IAAI,EAAE,EAAE,CAAC;AACtC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC"}

package/dist/tools/meta.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ToolContext } from './types.js';
+export declare function registerMetaTools(server: McpServer, ctx: ToolContext): void;

package/dist/tools/meta.js

@@ -0,0 +1,22 @@
+import { errorResult, jsonResult } from './types.js';
+export function registerMetaTools(server, ctx) {
+    server.tool('metadata_get', 'Return the GitLab instance metadata (version, revision, KAS info, enterprise flag). Useful as a smoke test for the configured base URL and token.', {}, async () => {
+        try {
+            const res = await ctx.rest.request({ path: '/metadata' });
+            return jsonResult(res.data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    server.tool('user_current', 'Return the authenticated user (the owner of the configured GITLAB_TOKEN). Smoke-tests authentication.', {}, async () => {
+        try {
+            const res = await ctx.rest.request({ path: '/user' });
+            return jsonResult(res.data);
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+}
+//# sourceMappingURL=meta.js.map

package/dist/tools/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/tools/meta.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAEvE,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,GAAgB;IACnE,MAAM,CAAC,IAAI,CACT,cAAc,EACd,mJAAmJ,EACnJ,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAU,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YACnE,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,cAAc,EACd,uGAAuG,EACvG,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}