gitlab-mcp 1.0.0 → 1.2.0

package/dist/index.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { env } from "./config/env.js";
+import { GitLabClient } from "./lib/gitlab-client.js";
+import { logger } from "./lib/logger.js";
+import { configureNetworkRuntime } from "./lib/network.js";
+import { OutputFormatter } from "./lib/output.js";
+import { ToolPolicyEngine } from "./lib/policy.js";
+import { GitLabRequestRuntime } from "./lib/request-runtime.js";
+import { createMcpServer } from "./server/build-server.js";
+async function main() {
+    const deniedToolsRegex = env.GITLAB_DENIED_TOOLS_REGEX
+        ? new RegExp(env.GITLAB_DENIED_TOOLS_REGEX)
+        : undefined;
+    configureNetworkRuntime(env, logger);
+    const requestRuntime = new GitLabRequestRuntime(env, logger);
+    const context = {
+        env,
+        logger,
+        gitlab: new GitLabClient(env.GITLAB_API_URL, env.GITLAB_PERSONAL_ACCESS_TOKEN, {
+            apiUrls: env.GITLAB_API_URLS,
+            timeoutMs: env.GITLAB_HTTP_TIMEOUT_MS,
+            beforeRequest: (requestContext) => requestRuntime.beforeRequest(requestContext)
+        }),
+        policy: new ToolPolicyEngine({
+            readOnlyMode: env.GITLAB_READ_ONLY_MODE,
+            allowedTools: env.GITLAB_ALLOWED_TOOLS,
+            deniedToolsRegex,
+            enabledFeatures: {
+                wiki: env.USE_GITLAB_WIKI,
+                milestone: env.USE_MILESTONE,
+                pipeline: env.USE_PIPELINE,
+                release: env.USE_RELEASE
+            }
+        }),
+        formatter: new OutputFormatter({
+            responseMode: env.GITLAB_RESPONSE_MODE,
+            maxBytes: env.GITLAB_MAX_RESPONSE_BYTES
+        })
+    };
+    const server = createMcpServer(context);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info({ transport: "stdio" }, "MCP server started");
+    const handleSignal = (signal) => {
+        void shutdown(signal, server);
+    };
+    process.once("SIGINT", () => handleSignal("SIGINT"));
+    process.once("SIGTERM", () => handleSignal("SIGTERM"));
+}
+async function shutdown(signal, server) {
+    logger.info({ signal }, "Shutting down MCP server");
+    try {
+        await server.close();
+    }
+    catch (error) {
+        logger.error({ err: error }, "Server close failed");
+    }
+    process.exit(0);
+}
+void main().catch((error) => {
+    logger.error({ err: error }, "Failed to start MCP server");
+    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":"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"}

package/dist/lib/auth-context.d.ts

@@ -0,0 +1,9 @@
+export interface SessionAuth {
+    sessionId?: string;
+    token?: string;
+    apiUrl?: string;
+    header?: "authorization" | "private-token";
+    updatedAt: number;
+}
+export declare function runWithSessionAuth<T>(auth: SessionAuth | undefined, callback: () => T): T;
+export declare function getSessionAuth(): SessionAuth | undefined;

package/dist/lib/auth-context.js

@@ -0,0 +1,9 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const sessionAuthStore = new AsyncLocalStorage();
+export function runWithSessionAuth(auth, callback) {
+    return sessionAuthStore.run(auth, callback);
+}
+export function getSessionAuth() {
+    return sessionAuthStore.getStore();
+}
+//# sourceMappingURL=auth-context.js.map

package/dist/lib/auth-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-context.js","sourceRoot":"","sources":["../../src/lib/auth-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAUrD,MAAM,gBAAgB,GAAG,IAAI,iBAAiB,EAA2B,CAAC;AAE1E,MAAM,UAAU,kBAAkB,CAAI,IAA6B,EAAE,QAAiB;IACpF,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,gBAAgB,CAAC,QAAQ,EAAE,CAAC;AACrC,CAAC"}

package/dist/lib/gitlab-client.d.ts

@@ -0,0 +1,331 @@
+import { type SessionAuth } from "./auth-context.js";
+export interface GitLabClientOptions {
+    timeoutMs?: number;
+    apiUrls?: string[];
+    maxAttachmentBytes?: number;
+    maxResponseBodyBytes?: number;
+    beforeRequest?: (context: GitLabBeforeRequestContext) => Promise<GitLabBeforeRequestResult | void>;
+}
+export interface GitLabRequestOptions {
+    query?: Record<string, string | number | boolean | undefined | null>;
+    body?: BodyInit;
+    headers?: HeadersInit;
+    token?: string;
+    apiUrl?: string;
+    authHeader?: "authorization" | "private-token";
+}
+export interface GitLabBeforeRequestContext {
+    url: URL;
+    method: string;
+    headers: Headers;
+    body?: BodyInit;
+    token?: string;
+    authHeader?: "authorization" | "private-token";
+}
+export interface GitLabBeforeRequestResult {
+    headers?: Headers;
+    body?: BodyInit;
+    token?: string;
+    authHeader?: "authorization" | "private-token";
+    fetchImpl?: typeof fetch;
+}
+export interface GitLabProject {
+    id: number;
+    name: string;
+    description: string | null;
+    path_with_namespace: string;
+    default_branch: string | null;
+    web_url: string;
+    visibility: string;
+    last_activity_at: string;
+}
+export interface PushFileAction {
+    action: "create" | "delete" | "move" | "update" | "chmod";
+    file_path: string;
+    previous_path?: string;
+    content?: string;
+    encoding?: "text" | "base64";
+    execute_filemode?: boolean;
+    last_commit_id?: string;
+}
+export interface MergeRequestCodeContextFile {
+    old_path: string;
+    new_path: string;
+    new_file: boolean;
+    renamed_file: boolean;
+    deleted_file: boolean;
+    diff: string;
+}
+export declare class GitLabApiError extends Error {
+    readonly status: number;
+    readonly details?: unknown | undefined;
+    constructor(message: string, status: number, details?: unknown | undefined);
+}
+export declare class GitLabClient {
+    private static readonly DEFAULT_MAX_ATTACHMENT_BYTES;
+    private static readonly DEFAULT_MAX_RESPONSE_BODY_BYTES;
+    private readonly baseApiUrl;
+    private readonly apiUrls;
+    private nextApiUrlIndex;
+    private readonly defaultToken?;
+    private readonly timeoutMs;
+    private readonly maxAttachmentBytes;
+    private readonly maxResponseBodyBytes;
+    private readonly beforeRequest?;
+    constructor(baseApiUrl: string, defaultToken?: string, options?: GitLabClientOptions);
+    getProject(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listProjects(options?: GitLabRequestOptions): Promise<unknown>;
+    createRepository(payload: {
+        name: string;
+        description?: string;
+        visibility?: "private" | "internal" | "public";
+        initialize_with_readme?: boolean;
+        path?: string;
+        namespace_id?: string | number;
+        default_branch?: string;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    listProjectMembers(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listGroupProjects(groupId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    forkRepository(projectId: string, payload?: {
+        namespace?: string;
+        namespace_id?: string | number;
+        path?: string;
+        name?: string;
+        description?: string;
+        visibility?: "private" | "internal" | "public";
+        default_branch?: string;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    searchProjects(search: string, limit?: number, options?: GitLabRequestOptions): Promise<unknown>;
+    searchRepositories(search: string, options?: GitLabRequestOptions): Promise<unknown>;
+    searchCodeBlobs(projectId: string, search: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getRepositoryTree(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getFileContents(projectId: string, filePath: string, ref: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createOrUpdateFile(projectId: string, filePath: string, payload: {
+        branch: string;
+        content: string;
+        commit_message: string;
+        author_email?: string;
+        author_name?: string;
+        encoding?: "text" | "base64";
+        execute_filemode?: boolean;
+        start_branch?: string;
+        last_commit_id?: string;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    pushFiles(projectId: string, payload: {
+        branch: string;
+        commit_message: string;
+        actions: PushFileAction[];
+        start_branch?: string;
+        author_name?: string;
+        author_email?: string;
+        force?: boolean;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    createBranch(projectId: string, payload: {
+        branch: string;
+        ref: string;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    getBranchDiffs(projectId: string, payload: {
+        from: string;
+        to: string;
+        straight?: boolean;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    listCommits(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getCommit(projectId: string, sha: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getCommitDiff(projectId: string, sha: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listMergeRequests(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listGlobalMergeRequests(options?: GitLabRequestOptions): Promise<unknown>;
+    getMergeRequest(projectId: string, mergeRequestIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createMergeRequest(projectId: string, payload: {
+        source_branch: string;
+        target_branch: string;
+        title: string;
+        description?: string;
+        target_project_id?: string | number;
+        assignee_ids?: number[];
+        reviewer_ids?: number[];
+        labels?: string;
+        allow_collaboration?: boolean;
+        remove_source_branch?: boolean;
+        squash?: boolean;
+        draft?: boolean;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    updateMergeRequest(projectId: string, mergeRequestIid: string, payload: Record<string, unknown>, options?: GitLabRequestOptions): Promise<unknown>;
+    mergeMergeRequest(projectId: string, mergeRequestIid: string, payload?: Record<string, unknown>, options?: GitLabRequestOptions): Promise<unknown>;
+    getMergeRequestDiffs(projectId: string, mergeRequestIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listMergeRequestDiffs(projectId: string, mergeRequestIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listMergeRequestVersions(projectId: string, mergeRequestIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getMergeRequestVersion(projectId: string, mergeRequestIid: string, versionId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    approveMergeRequest(projectId: string, mergeRequestIid: string, payload?: Record<string, unknown>, options?: GitLabRequestOptions): Promise<unknown>;
+    unapproveMergeRequest(projectId: string, mergeRequestIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getMergeRequestApprovalState(projectId: string, mergeRequestIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listMergeRequestDiscussions(projectId: string, mergeRequestIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createMergeRequestDiscussionNote(projectId: string, mergeRequestIid: string, discussionId: string, payload: {
+        body: string;
+        created_at?: string;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    createMergeRequestThread(projectId: string, mergeRequestIid: string, payload: {
+        body: string;
+        position?: Record<string, unknown>;
+        created_at?: string;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    updateMergeRequestDiscussionNote(projectId: string, mergeRequestIid: string, discussionId: string, noteId: string, payload: {
+        body?: string;
+        resolved?: boolean;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    deleteMergeRequestDiscussionNote(projectId: string, mergeRequestIid: string, discussionId: string, noteId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    resolveMergeRequestThread(projectId: string, mergeRequestIid: string, discussionId: string, noteId: string, resolved: boolean, options?: GitLabRequestOptions): Promise<unknown>;
+    listMergeRequestNotes(projectId: string, mergeRequestIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getMergeRequestNote(projectId: string, mergeRequestIid: string, noteId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createMergeRequestNote(projectId: string, mergeRequestIid: string, body: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getDraftNote(projectId: string, mergeRequestIid: string, draftNoteId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listDraftNotes(projectId: string, mergeRequestIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createDraftNote(projectId: string, mergeRequestIid: string, payload: {
+        body: string;
+        position?: Record<string, unknown>;
+        resolve_discussion?: boolean;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    updateDraftNote(projectId: string, mergeRequestIid: string, draftNoteId: string, payload: {
+        body?: string;
+        position?: Record<string, unknown>;
+        resolve_discussion?: boolean;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    deleteDraftNote(projectId: string, mergeRequestIid: string, draftNoteId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    publishDraftNote(projectId: string, mergeRequestIid: string, draftNoteId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    bulkPublishDraftNotes(projectId: string, mergeRequestIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createNote(projectId: string, noteableType: "issue" | "merge_request", noteableIid: string, body: string, options?: GitLabRequestOptions): Promise<unknown>;
+    updateMergeRequestNote(projectId: string, mergeRequestIid: string, noteId: string, body: string, options?: GitLabRequestOptions): Promise<unknown>;
+    deleteMergeRequestNote(projectId: string, mergeRequestIid: string, noteId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listIssues(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listGlobalIssues(options?: GitLabRequestOptions): Promise<unknown>;
+    getIssue(projectId: string, issueIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createIssue(projectId: string, payload: {
+        title: string;
+        description?: string;
+        assignee_ids?: number[];
+        labels?: string;
+        milestone_id?: number;
+        due_date?: string;
+        confidential?: boolean;
+        issue_type?: string;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    updateIssue(projectId: string, issueIid: string, payload: Record<string, unknown>, options?: GitLabRequestOptions): Promise<unknown>;
+    deleteIssue(projectId: string, issueIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    myIssues(payload: {
+        project_id?: string;
+        state?: "opened" | "closed" | "all";
+        labels?: string;
+        milestone?: string;
+        search?: string;
+        created_after?: string;
+        created_before?: string;
+        updated_after?: string;
+        updated_before?: string;
+        per_page?: number;
+        page?: number;
+        scope?: string;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    listIssueDiscussions(projectId: string, issueIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createIssueNote(projectId: string, issueIid: string, payload: {
+        body: string;
+        discussion_id?: string;
+        created_at?: string;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    updateIssueNote(projectId: string, issueIid: string, discussionId: string, noteId: string, payload: {
+        body?: string;
+        resolved?: boolean;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    listIssueLinks(projectId: string, issueIid: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getIssueLink(projectId: string, issueIid: string, issueLinkId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createIssueLink(projectId: string, issueIid: string, payload: {
+        target_project_id: string;
+        target_issue_iid: string;
+        link_type?: "relates_to" | "blocks" | "is_blocked_by";
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    deleteIssueLink(projectId: string, issueIid: string, issueLinkId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listWikiPages(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getWikiPage(projectId: string, slug: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createWikiPage(projectId: string, payload: {
+        title: string;
+        content: string;
+        format?: "markdown" | "rdoc" | "asciidoc" | "org";
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    updateWikiPage(projectId: string, slug: string, payload: {
+        content: string;
+        title?: string;
+        format?: "markdown" | "rdoc" | "asciidoc" | "org";
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    deleteWikiPage(projectId: string, slug: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listPipelines(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getPipeline(projectId: string, pipelineId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listPipelineJobs(projectId: string, pipelineId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listPipelineTriggerJobs(projectId: string, pipelineId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getPipelineJob(projectId: string, jobId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getPipelineJobOutput(projectId: string, jobId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createPipeline(projectId: string, payload: {
+        ref: string;
+        variables?: Array<{
+            key: string;
+            value: string;
+            variable_type?: "env_var" | "file";
+        }>;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    retryPipeline(projectId: string, pipelineId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    cancelPipeline(projectId: string, pipelineId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    retryPipelineJob(projectId: string, jobId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    cancelPipelineJob(projectId: string, jobId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    playPipelineJob(projectId: string, jobId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listMilestones(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getMilestone(projectId: string, milestoneId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createMilestone(projectId: string, payload: {
+        title: string;
+        description?: string;
+        due_date?: string;
+        start_date?: string;
+    }, options?: GitLabRequestOptions): Promise<unknown>;
+    updateMilestone(projectId: string, milestoneId: string, payload: Record<string, unknown>, options?: GitLabRequestOptions): Promise<unknown>;
+    deleteMilestone(projectId: string, milestoneId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getMilestoneIssues(projectId: string, milestoneId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getMilestoneMergeRequests(projectId: string, milestoneId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    promoteMilestone(projectId: string, milestoneId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getMilestoneBurndownEvents(projectId: string, milestoneId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listReleases(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getRelease(projectId: string, tagName: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createRelease(projectId: string, payload: Record<string, unknown>, options?: GitLabRequestOptions): Promise<unknown>;
+    updateRelease(projectId: string, tagName: string, payload: Record<string, unknown>, options?: GitLabRequestOptions): Promise<unknown>;
+    deleteRelease(projectId: string, tagName: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createReleaseEvidence(projectId: string, tagName: string, options?: GitLabRequestOptions): Promise<unknown>;
+    downloadReleaseAsset(projectId: string, tagName: string, directAssetPath: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listLabels(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getLabel(projectId: string, labelId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    createLabel(projectId: string, payload: Record<string, unknown>, options?: GitLabRequestOptions): Promise<unknown>;
+    updateLabel(projectId: string, payload: Record<string, unknown>, options?: GitLabRequestOptions): Promise<unknown>;
+    deleteLabel(projectId: string, labelName: string, options?: GitLabRequestOptions): Promise<unknown>;
+    listNamespaces(options?: GitLabRequestOptions): Promise<unknown>;
+    listGroupIterations(groupId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getNamespace(namespaceIdOrPath: string, options?: GitLabRequestOptions): Promise<unknown>;
+    verifyNamespace(pathName: string, options?: GitLabRequestOptions): Promise<unknown>;
+    getUsers(options?: GitLabRequestOptions): Promise<unknown>;
+    listEvents(options?: GitLabRequestOptions): Promise<unknown>;
+    getProjectEvents(projectId: string, options?: GitLabRequestOptions): Promise<unknown>;
+    uploadMarkdown(projectId: string, content: string, filename: string, options?: GitLabRequestOptions): Promise<unknown>;
+    uploadMarkdownFile(projectId: string, filePath: string, options?: GitLabRequestOptions): Promise<unknown>;
+    downloadAttachment(urlOrPath: string, options?: GitLabRequestOptions): Promise<{
+        fileName: string;
+        contentType: string;
+        base64: string;
+    }>;
+    executeGraphql(query: string, variables: Record<string, unknown> | undefined, options?: GitLabRequestOptions): Promise<unknown>;
+    get(path: string, options?: GitLabRequestOptions): Promise<unknown>;
+    post(path: string, options?: GitLabRequestOptions): Promise<unknown>;
+    put(path: string, options?: GitLabRequestOptions): Promise<unknown>;
+    delete(path: string, options?: GitLabRequestOptions): Promise<unknown>;
+    private request;
+    private rawRequest;
+    private parseResponseBody;
+    private resolveRequestConfig;
+    private pickApiUrl;
+    private resolveAbsoluteUrl;
+    private resolveAttachmentUrl;
+    private attachAuth;
+}
+export declare function getEffectiveSessionAuth(defaultToken?: string, defaultApiUrl?: string): SessionAuth;