@ekho/gitlab-mcp 1.1.0

package/dist/tools/registry.d.ts

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

package/dist/tools/registry.js

@@ -0,0 +1,117 @@
+import { registerMetaTools } from './meta.js';
+import { registerMergeRequestTools } from '../groups/merge_requests/tools.js';
+import { registerDiscussionTools } from '../groups/discussions/tools.js';
+import { registerWorkItemTools } from '../groups/work_items/tools.js';
+import { registerLabelTools } from '../groups/labels/tools.js';
+import { registerMilestoneTools } from '../groups/milestones/tools.js';
+import { registerBoardTools } from '../groups/boards/tools.js';
+import { registerTodoTools } from '../groups/todos/tools.js';
+import { registerPipelineTools } from '../groups/pipelines/tools.js';
+import { registerJobTools } from '../groups/jobs/tools.js';
+import { registerPipelineScheduleTools } from '../groups/pipeline_schedules/tools.js';
+import { registerPipelineTriggerTools } from '../groups/pipeline_triggers/tools.js';
+import { registerCiVariableTools } from '../groups/ci_variables/tools.js';
+import { registerRunnerTools } from '../groups/runners/tools.js';
+import { registerCiLintTools } from '../groups/ci_lint/tools.js';
+import { registerCiCatalogTools } from '../groups/ci_catalog/tools.js';
+import { registerProjectTools } from '../groups/projects/tools.js';
+import { registerGroupTools } from '../groups/groups/tools.js';
+import { registerRepositoryFileTools } from '../groups/repository_files/tools.js';
+import { registerBranchTools } from '../groups/branches/tools.js';
+import { registerTagTools } from '../groups/tags/tools.js';
+import { registerCommitTools } from '../groups/commits/tools.js';
+import { registerCodeSearchTools } from '../groups/code_search/tools.js';
+import { registerReleaseTools } from '../groups/releases/tools.js';
+import { registerEnvironmentTools } from '../groups/environments/tools.js';
+import { registerDeploymentTools } from '../groups/deployments/tools.js';
+import { registerFeatureFlagTools } from '../groups/feature_flags/tools.js';
+import { registerPackageTools } from '../groups/packages/tools.js';
+import { registerContainerRegistryTools } from '../groups/container_registry/tools.js';
+import { registerUserTools } from '../groups/users/tools.js';
+import { registerMemberTools } from '../groups/members/tools.js';
+import { registerAccessTokenTools } from '../groups/access_tokens/tools.js';
+import { registerKeyTools } from '../groups/keys/tools.js';
+import { registerCustomRoleTools } from '../groups/custom_roles/tools.js';
+import { registerVulnerabilityTools } from '../groups/vulnerabilities/tools.js';
+import { registerSecurityReportTools } from '../groups/security_reports/tools.js';
+import { registerSecurityPolicyTools } from '../groups/security_policies/tools.js';
+import { registerComplianceTools } from '../groups/compliance/tools.js';
+import { registerAuditEventTools } from '../groups/audit_events/tools.js';
+import { registerSecretsTools } from '../groups/secrets/tools.js';
+import { registerProtectedEnvironmentTools } from '../groups/protected_environments/tools.js';
+import { registerWebhookTools } from '../groups/webhooks/tools.js';
+import { registerIntegrationTools } from '../groups/integrations/tools.js';
+import { registerEventTools } from '../groups/events/tools.js';
+import { registerWikiTools } from '../groups/wiki/tools.js';
+import { registerSnippetTools } from '../groups/snippets/tools.js';
+import { registerSearchTools } from '../groups/search/tools.js';
+import { registerAnalyticsTools } from '../groups/analytics/tools.js';
+import { registerStatisticsTools } from '../groups/statistics/tools.js';
+import { registerAdminTools } from '../groups/admin/tools.js';
+import { registerDuoChatTools } from '../groups/duo_chat/tools.js';
+import { registerAiCatalogTools } from '../groups/ai_catalog/tools.js';
+export function registerAllTools(server, ctx) {
+    registerMetaTools(server, ctx);
+    // Phase 1 — Group B: Collaboration
+    registerMergeRequestTools(server, ctx);
+    registerDiscussionTools(server, ctx);
+    registerWorkItemTools(server, ctx);
+    registerLabelTools(server, ctx);
+    registerMilestoneTools(server, ctx);
+    registerBoardTools(server, ctx);
+    registerTodoTools(server, ctx);
+    // Phase 2 — Group C: CI/CD
+    registerPipelineTools(server, ctx);
+    registerJobTools(server, ctx);
+    registerPipelineScheduleTools(server, ctx);
+    registerPipelineTriggerTools(server, ctx);
+    registerCiVariableTools(server, ctx);
+    registerRunnerTools(server, ctx);
+    registerCiLintTools(server, ctx);
+    registerCiCatalogTools(server, ctx);
+    // Phase 3 — Group A: Code & Repository
+    registerProjectTools(server, ctx);
+    registerGroupTools(server, ctx);
+    registerRepositoryFileTools(server, ctx);
+    registerBranchTools(server, ctx);
+    registerTagTools(server, ctx);
+    registerCommitTools(server, ctx);
+    registerCodeSearchTools(server, ctx);
+    // Phase 4 — Group D: Releases & Delivery
+    registerReleaseTools(server, ctx);
+    registerEnvironmentTools(server, ctx);
+    registerDeploymentTools(server, ctx);
+    registerFeatureFlagTools(server, ctx);
+    registerPackageTools(server, ctx);
+    registerContainerRegistryTools(server, ctx);
+    // Phase 5 — Group F: Access & Users
+    registerUserTools(server, ctx);
+    registerMemberTools(server, ctx);
+    registerAccessTokenTools(server, ctx);
+    registerKeyTools(server, ctx);
+    registerCustomRoleTools(server, ctx);
+    // Phase 6 — Group E: Security & Compliance
+    registerVulnerabilityTools(server, ctx);
+    registerSecurityReportTools(server, ctx);
+    registerSecurityPolicyTools(server, ctx);
+    registerComplianceTools(server, ctx);
+    registerAuditEventTools(server, ctx);
+    registerSecretsTools(server, ctx);
+    registerProtectedEnvironmentTools(server, ctx);
+    // Phase 7 — Group G: Integrations & Events
+    registerWebhookTools(server, ctx);
+    registerIntegrationTools(server, ctx);
+    registerEventTools(server, ctx);
+    // Phase 8 — Group H: Content
+    registerWikiTools(server, ctx);
+    registerSnippetTools(server, ctx);
+    registerSearchTools(server, ctx);
+    // Phase 9 — Group J: Analytics & Admin
+    registerAnalyticsTools(server, ctx);
+    registerStatisticsTools(server, ctx);
+    registerAdminTools(server, ctx);
+    // Phase 10 — Group I: AI / GitLab Duo
+    registerDuoChatTools(server, ctx);
+    registerAiCatalogTools(server, ctx);
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,18 @@
+import type { RestClient } from '../http/rest.js';
+import type { GraphQLClient } from '../http/graphql.js';
+import type { Config } from '../config.js';
+export interface ToolContext {
+    config: Config;
+    rest: RestClient;
+    graphql: GraphQLClient;
+}
+export interface ToolResultContent {
+    [key: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare function jsonResult(value: unknown): ToolResultContent;
+export declare function errorResult(err: unknown): ToolResultContent;

package/dist/tools/types.js

@@ -0,0 +1,20 @@
+export function jsonResult(value) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(value, null, 2),
+            },
+        ],
+    };
+}
+export function errorResult(err) {
+    const msg = err instanceof Error
+        ? `${err.name}: ${err.message}`
+        : `Unknown error: ${JSON.stringify(err)}`;
+    return {
+        content: [{ type: 'text', text: msg }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;aACrC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,MAAM,GAAG,GACP,GAAG,YAAY,KAAK;QAClB,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE;QAC/B,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QACtC,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@ekho/gitlab-mcp",
+  "version": "1.1.0",
+  "description": "Model Context Protocol server for GitLab — full coverage of REST + GraphQL APIs across collaboration, CI/CD, code, releases, access, security, integrations, content, analytics, and Duo AI.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Boris Gorbylev",
+  "homepage": "https://gitlab.com/ekho_0/gitlab-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/ekho_0/gitlab-mcp.git"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/ekho_0/gitlab-mcp/-/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "gitlab",
+    "graphql",
+    "ai",
+    "claude",
+    "claude-code",
+    "anthropic",
+    "duo"
+  ],
+  "bin": {
+    "gitlab-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "PLAN.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:smoke": "vitest run --config vitest.smoke.config.ts",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run typecheck && npm test && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "undici": "^7.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.18.0",
+    "@typescript-eslint/parser": "^8.18.0",
+    "eslint": "^9.17.0",
+    "prettier": "^3.4.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}