@ekho/gitlab-mcp 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (226) hide show
  1. package/LICENSE +21 -0
  2. package/PLAN.md +517 -0
  3. package/README.md +429 -0
  4. package/dist/config.d.ts +35 -0
  5. package/dist/config.js +59 -0
  6. package/dist/config.js.map +1 -0
  7. package/dist/groups/access_tokens/tools.d.ts +3 -0
  8. package/dist/groups/access_tokens/tools.js +198 -0
  9. package/dist/groups/access_tokens/tools.js.map +1 -0
  10. package/dist/groups/admin/tools.d.ts +3 -0
  11. package/dist/groups/admin/tools.js +136 -0
  12. package/dist/groups/admin/tools.js.map +1 -0
  13. package/dist/groups/ai_catalog/queries.d.ts +3 -0
  14. package/dist/groups/ai_catalog/queries.js +75 -0
  15. package/dist/groups/ai_catalog/queries.js.map +1 -0
  16. package/dist/groups/ai_catalog/tools.d.ts +3 -0
  17. package/dist/groups/ai_catalog/tools.js +40 -0
  18. package/dist/groups/ai_catalog/tools.js.map +1 -0
  19. package/dist/groups/analytics/queries.d.ts +1 -0
  20. package/dist/groups/analytics/queries.js +28 -0
  21. package/dist/groups/analytics/queries.js.map +1 -0
  22. package/dist/groups/analytics/tools.d.ts +3 -0
  23. package/dist/groups/analytics/tools.js +110 -0
  24. package/dist/groups/analytics/tools.js.map +1 -0
  25. package/dist/groups/audit_events/tools.d.ts +3 -0
  26. package/dist/groups/audit_events/tools.js +112 -0
  27. package/dist/groups/audit_events/tools.js.map +1 -0
  28. package/dist/groups/boards/tools.d.ts +3 -0
  29. package/dist/groups/boards/tools.js +46 -0
  30. package/dist/groups/boards/tools.js.map +1 -0
  31. package/dist/groups/branches/tools.d.ts +3 -0
  32. package/dist/groups/branches/tools.js +122 -0
  33. package/dist/groups/branches/tools.js.map +1 -0
  34. package/dist/groups/ci_catalog/queries.d.ts +2 -0
  35. package/dist/groups/ci_catalog/queries.js +63 -0
  36. package/dist/groups/ci_catalog/queries.js.map +1 -0
  37. package/dist/groups/ci_catalog/tools.d.ts +3 -0
  38. package/dist/groups/ci_catalog/tools.js +45 -0
  39. package/dist/groups/ci_catalog/tools.js.map +1 -0
  40. package/dist/groups/ci_lint/tools.d.ts +3 -0
  41. package/dist/groups/ci_lint/tools.js +36 -0
  42. package/dist/groups/ci_lint/tools.js.map +1 -0
  43. package/dist/groups/ci_variables/tools.d.ts +3 -0
  44. package/dist/groups/ci_variables/tools.js +201 -0
  45. package/dist/groups/ci_variables/tools.js.map +1 -0
  46. package/dist/groups/code_search/tools.d.ts +3 -0
  47. package/dist/groups/code_search/tools.js +70 -0
  48. package/dist/groups/code_search/tools.js.map +1 -0
  49. package/dist/groups/commits/tools.d.ts +3 -0
  50. package/dist/groups/commits/tools.js +192 -0
  51. package/dist/groups/commits/tools.js.map +1 -0
  52. package/dist/groups/compliance/queries.d.ts +1 -0
  53. package/dist/groups/compliance/queries.js +22 -0
  54. package/dist/groups/compliance/queries.js.map +1 -0
  55. package/dist/groups/compliance/tools.d.ts +3 -0
  56. package/dist/groups/compliance/tools.js +104 -0
  57. package/dist/groups/compliance/tools.js.map +1 -0
  58. package/dist/groups/container_registry/tools.d.ts +3 -0
  59. package/dist/groups/container_registry/tools.js +113 -0
  60. package/dist/groups/container_registry/tools.js.map +1 -0
  61. package/dist/groups/custom_roles/queries.d.ts +5 -0
  62. package/dist/groups/custom_roles/queries.js +69 -0
  63. package/dist/groups/custom_roles/queries.js.map +1 -0
  64. package/dist/groups/custom_roles/tools.d.ts +3 -0
  65. package/dist/groups/custom_roles/tools.js +84 -0
  66. package/dist/groups/custom_roles/tools.js.map +1 -0
  67. package/dist/groups/deployments/tools.d.ts +3 -0
  68. package/dist/groups/deployments/tools.js +98 -0
  69. package/dist/groups/deployments/tools.js.map +1 -0
  70. package/dist/groups/discussions/tools.d.ts +3 -0
  71. package/dist/groups/discussions/tools.js +144 -0
  72. package/dist/groups/discussions/tools.js.map +1 -0
  73. package/dist/groups/duo_chat/queries.d.ts +4 -0
  74. package/dist/groups/duo_chat/queries.js +76 -0
  75. package/dist/groups/duo_chat/queries.js.map +1 -0
  76. package/dist/groups/duo_chat/tools.d.ts +3 -0
  77. package/dist/groups/duo_chat/tools.js +95 -0
  78. package/dist/groups/duo_chat/tools.js.map +1 -0
  79. package/dist/groups/environments/tools.d.ts +3 -0
  80. package/dist/groups/environments/tools.js +105 -0
  81. package/dist/groups/environments/tools.js.map +1 -0
  82. package/dist/groups/events/tools.d.ts +3 -0
  83. package/dist/groups/events/tools.js +64 -0
  84. package/dist/groups/events/tools.js.map +1 -0
  85. package/dist/groups/feature_flags/tools.d.ts +3 -0
  86. package/dist/groups/feature_flags/tools.js +137 -0
  87. package/dist/groups/feature_flags/tools.js.map +1 -0
  88. package/dist/groups/groups/tools.d.ts +3 -0
  89. package/dist/groups/groups/tools.js +145 -0
  90. package/dist/groups/groups/tools.js.map +1 -0
  91. package/dist/groups/integrations/tools.d.ts +3 -0
  92. package/dist/groups/integrations/tools.js +143 -0
  93. package/dist/groups/integrations/tools.js.map +1 -0
  94. package/dist/groups/jobs/tools.d.ts +3 -0
  95. package/dist/groups/jobs/tools.js +209 -0
  96. package/dist/groups/jobs/tools.js.map +1 -0
  97. package/dist/groups/keys/tools.d.ts +3 -0
  98. package/dist/groups/keys/tools.js +140 -0
  99. package/dist/groups/keys/tools.js.map +1 -0
  100. package/dist/groups/labels/tools.d.ts +3 -0
  101. package/dist/groups/labels/tools.js +110 -0
  102. package/dist/groups/labels/tools.js.map +1 -0
  103. package/dist/groups/members/tools.d.ts +3 -0
  104. package/dist/groups/members/tools.js +136 -0
  105. package/dist/groups/members/tools.js.map +1 -0
  106. package/dist/groups/merge_requests/tools.d.ts +3 -0
  107. package/dist/groups/merge_requests/tools.js +288 -0
  108. package/dist/groups/merge_requests/tools.js.map +1 -0
  109. package/dist/groups/milestones/tools.d.ts +3 -0
  110. package/dist/groups/milestones/tools.js +143 -0
  111. package/dist/groups/milestones/tools.js.map +1 -0
  112. package/dist/groups/packages/tools.d.ts +3 -0
  113. package/dist/groups/packages/tools.js +157 -0
  114. package/dist/groups/packages/tools.js.map +1 -0
  115. package/dist/groups/pipeline_schedules/tools.d.ts +3 -0
  116. package/dist/groups/pipeline_schedules/tools.js +127 -0
  117. package/dist/groups/pipeline_schedules/tools.js.map +1 -0
  118. package/dist/groups/pipeline_triggers/tools.d.ts +3 -0
  119. package/dist/groups/pipeline_triggers/tools.js +74 -0
  120. package/dist/groups/pipeline_triggers/tools.js.map +1 -0
  121. package/dist/groups/pipelines/tools.d.ts +3 -0
  122. package/dist/groups/pipelines/tools.js +140 -0
  123. package/dist/groups/pipelines/tools.js.map +1 -0
  124. package/dist/groups/projects/tools.d.ts +3 -0
  125. package/dist/groups/projects/tools.js +189 -0
  126. package/dist/groups/projects/tools.js.map +1 -0
  127. package/dist/groups/protected_environments/tools.d.ts +3 -0
  128. package/dist/groups/protected_environments/tools.js +77 -0
  129. package/dist/groups/protected_environments/tools.js.map +1 -0
  130. package/dist/groups/releases/tools.d.ts +3 -0
  131. package/dist/groups/releases/tools.js +153 -0
  132. package/dist/groups/releases/tools.js.map +1 -0
  133. package/dist/groups/repository_files/tools.d.ts +3 -0
  134. package/dist/groups/repository_files/tools.js +163 -0
  135. package/dist/groups/repository_files/tools.js.map +1 -0
  136. package/dist/groups/runners/tools.d.ts +3 -0
  137. package/dist/groups/runners/tools.js +108 -0
  138. package/dist/groups/runners/tools.js.map +1 -0
  139. package/dist/groups/search/tools.d.ts +3 -0
  140. package/dist/groups/search/tools.js +58 -0
  141. package/dist/groups/search/tools.js.map +1 -0
  142. package/dist/groups/secrets/queries.d.ts +10 -0
  143. package/dist/groups/secrets/queries.js +121 -0
  144. package/dist/groups/secrets/queries.js.map +1 -0
  145. package/dist/groups/secrets/tools.d.ts +8 -0
  146. package/dist/groups/secrets/tools.js +167 -0
  147. package/dist/groups/secrets/tools.js.map +1 -0
  148. package/dist/groups/security_policies/queries.d.ts +3 -0
  149. package/dist/groups/security_policies/queries.js +75 -0
  150. package/dist/groups/security_policies/queries.js.map +1 -0
  151. package/dist/groups/security_policies/tools.d.ts +3 -0
  152. package/dist/groups/security_policies/tools.js +40 -0
  153. package/dist/groups/security_policies/tools.js.map +1 -0
  154. package/dist/groups/security_reports/queries.d.ts +1 -0
  155. package/dist/groups/security_reports/queries.js +75 -0
  156. package/dist/groups/security_reports/queries.js.map +1 -0
  157. package/dist/groups/security_reports/tools.d.ts +3 -0
  158. package/dist/groups/security_reports/tools.js +51 -0
  159. package/dist/groups/security_reports/tools.js.map +1 -0
  160. package/dist/groups/snippets/tools.d.ts +3 -0
  161. package/dist/groups/snippets/tools.js +148 -0
  162. package/dist/groups/snippets/tools.js.map +1 -0
  163. package/dist/groups/statistics/queries.d.ts +2 -0
  164. package/dist/groups/statistics/queries.js +32 -0
  165. package/dist/groups/statistics/queries.js.map +1 -0
  166. package/dist/groups/statistics/tools.d.ts +3 -0
  167. package/dist/groups/statistics/tools.js +35 -0
  168. package/dist/groups/statistics/tools.js.map +1 -0
  169. package/dist/groups/tags/tools.d.ts +3 -0
  170. package/dist/groups/tags/tools.js +97 -0
  171. package/dist/groups/tags/tools.js.map +1 -0
  172. package/dist/groups/todos/tools.d.ts +3 -0
  173. package/dist/groups/todos/tools.js +93 -0
  174. package/dist/groups/todos/tools.js.map +1 -0
  175. package/dist/groups/users/tools.d.ts +3 -0
  176. package/dist/groups/users/tools.js +121 -0
  177. package/dist/groups/users/tools.js.map +1 -0
  178. package/dist/groups/vulnerabilities/queries.d.ts +3 -0
  179. package/dist/groups/vulnerabilities/queries.js +104 -0
  180. package/dist/groups/vulnerabilities/queries.js.map +1 -0
  181. package/dist/groups/vulnerabilities/tools.d.ts +3 -0
  182. package/dist/groups/vulnerabilities/tools.js +131 -0
  183. package/dist/groups/vulnerabilities/tools.js.map +1 -0
  184. package/dist/groups/webhooks/tools.d.ts +3 -0
  185. package/dist/groups/webhooks/tools.js +213 -0
  186. package/dist/groups/webhooks/tools.js.map +1 -0
  187. package/dist/groups/wiki/tools.d.ts +3 -0
  188. package/dist/groups/wiki/tools.js +142 -0
  189. package/dist/groups/wiki/tools.js.map +1 -0
  190. package/dist/groups/work_items/queries.d.ts +16 -0
  191. package/dist/groups/work_items/queries.js +181 -0
  192. package/dist/groups/work_items/queries.js.map +1 -0
  193. package/dist/groups/work_items/tools.d.ts +3 -0
  194. package/dist/groups/work_items/tools.js +250 -0
  195. package/dist/groups/work_items/tools.js.map +1 -0
  196. package/dist/http/errors.d.ts +21 -0
  197. package/dist/http/errors.js +62 -0
  198. package/dist/http/errors.js.map +1 -0
  199. package/dist/http/graphql.d.ts +29 -0
  200. package/dist/http/graphql.js +93 -0
  201. package/dist/http/graphql.js.map +1 -0
  202. package/dist/http/rest.d.ts +96 -0
  203. package/dist/http/rest.js +369 -0
  204. package/dist/http/rest.js.map +1 -0
  205. package/dist/index.d.ts +2 -0
  206. package/dist/index.js +25 -0
  207. package/dist/index.js.map +1 -0
  208. package/dist/shared/args.d.ts +51 -0
  209. package/dist/shared/args.js +46 -0
  210. package/dist/shared/args.js.map +1 -0
  211. package/dist/shared/handlers.d.ts +6 -0
  212. package/dist/shared/handlers.js +14 -0
  213. package/dist/shared/handlers.js.map +1 -0
  214. package/dist/shared/ids.d.ts +18 -0
  215. package/dist/shared/ids.js +43 -0
  216. package/dist/shared/ids.js.map +1 -0
  217. package/dist/tools/meta.d.ts +3 -0
  218. package/dist/tools/meta.js +22 -0
  219. package/dist/tools/meta.js.map +1 -0
  220. package/dist/tools/registry.d.ts +3 -0
  221. package/dist/tools/registry.js +117 -0
  222. package/dist/tools/registry.js.map +1 -0
  223. package/dist/tools/types.d.ts +18 -0
  224. package/dist/tools/types.js +20 -0
  225. package/dist/tools/types.js.map +1 -0
  226. package/package.json +72 -0
@@ -0,0 +1,110 @@
1
+ import { z } from 'zod';
2
+ import { GroupIdArg, IdOrPath, PaginationArgs, ProjectIdArg } from '../../shared/args.js';
3
+ import { safe } from '../../shared/handlers.js';
4
+ import { resolveGroupId, resolveProjectId } from '../../shared/ids.js';
5
+ import { USAGE_TRENDS } from './queries.js';
6
+ const DoraMetric = z.enum([
7
+ 'deployment_frequency',
8
+ 'lead_time_for_changes',
9
+ 'change_failure_rate',
10
+ 'time_to_restore_service',
11
+ ]);
12
+ const DoraInterval = z.enum(['all', 'monthly', 'daily']);
13
+ const EnvironmentTier = z.enum(['production', 'staging', 'testing', 'development', 'other']);
14
+ const UsageMeasurement = z.enum([
15
+ 'PROJECTS',
16
+ 'USERS',
17
+ 'ISSUES',
18
+ 'MERGE_REQUESTS',
19
+ 'GROUPS',
20
+ 'PIPELINES',
21
+ 'PIPELINES_SUCCEEDED',
22
+ 'PIPELINES_FAILED',
23
+ 'PIPELINES_CANCELED',
24
+ 'PIPELINES_SKIPPED',
25
+ ]);
26
+ export function registerAnalyticsTools(server, ctx) {
27
+ server.tool('dora_metrics_project', 'Get DORA metrics for a project (Ultimate).', {
28
+ ...ProjectIdArg,
29
+ metric: DoraMetric,
30
+ interval: DoraInterval.optional(),
31
+ start_date: z.string().optional().describe('YYYY-MM-DD'),
32
+ end_date: z.string().optional(),
33
+ environment_tiers: z.array(EnvironmentTier).optional(),
34
+ }, async (args) => safe(async () => {
35
+ const projectId = resolveProjectId(ctx.config, args.project_id);
36
+ const { project_id: _p, ...rest } = args;
37
+ const res = await ctx.rest.request({
38
+ path: `/projects/${projectId}/dora/metrics`,
39
+ query: rest,
40
+ });
41
+ return res.data;
42
+ }));
43
+ server.tool('dora_metrics_group', 'Get DORA metrics aggregated for a group (Ultimate).', {
44
+ ...GroupIdArg,
45
+ metric: DoraMetric,
46
+ interval: DoraInterval.optional(),
47
+ start_date: z.string().optional(),
48
+ end_date: z.string().optional(),
49
+ environment_tiers: z.array(EnvironmentTier).optional(),
50
+ }, async (args) => safe(async () => {
51
+ const groupId = resolveGroupId(ctx.config, args.group_id);
52
+ const { group_id: _g, ...rest } = args;
53
+ const res = await ctx.rest.request({
54
+ path: `/groups/${groupId}/dora/metrics`,
55
+ query: rest,
56
+ });
57
+ return res.data;
58
+ }));
59
+ server.tool('contribution_analytics_group', 'Per-member contribution counts (commits, issues, MRs) for a group over a date range.', {
60
+ ...GroupIdArg,
61
+ from: z.string().optional().describe('YYYY-MM-DD'),
62
+ to: z.string().optional(),
63
+ ...PaginationArgs,
64
+ }, async (args) => safe(async () => {
65
+ const groupId = resolveGroupId(ctx.config, args.group_id);
66
+ const { group_id: _g, ...rest } = args;
67
+ const res = await ctx.rest.request({
68
+ path: `/groups/${groupId}/contribution_analytics`,
69
+ query: rest,
70
+ });
71
+ return res.data;
72
+ }));
73
+ for (const kind of ['issues_count', 'merge_requests_count', 'new_members_count']) {
74
+ server.tool(`group_activity_${kind}`, `Number of ${kind.replace('_count', '').replace('_', ' ')} created in a group within a date range.`, {
75
+ group_id: IdOrPath,
76
+ start_date: z.string().optional(),
77
+ end_date: z.string().optional(),
78
+ }, async (args) => safe(async () => {
79
+ const { group_id, ...rest } = args;
80
+ const res = await ctx.rest.request({
81
+ path: `/analytics/group_activity/${kind}`,
82
+ query: { group_id: String(group_id), ...rest },
83
+ });
84
+ return res.data;
85
+ }));
86
+ }
87
+ server.tool('usage_trends_get', 'Get instance-level usage trends (admin). Identifier examples: PROJECTS, USERS, ISSUES, MERGE_REQUESTS, PIPELINES.', {
88
+ identifier: UsageMeasurement,
89
+ first: z.number().int().positive().max(365).optional(),
90
+ after: z.string().optional(),
91
+ recorded_after: z.string().optional().describe('ISO 8601'),
92
+ recorded_before: z.string().optional(),
93
+ }, async (args) => safe(async () => {
94
+ const data = await ctx.graphql.query({
95
+ query: USAGE_TRENDS,
96
+ variables: {
97
+ identifier: args.identifier,
98
+ first: args.first ?? 30,
99
+ after: args.after,
100
+ recordedAfter: args.recorded_after,
101
+ recordedBefore: args.recorded_before,
102
+ },
103
+ });
104
+ return {
105
+ items: data.usageTrendsMeasurements.nodes,
106
+ page_info: data.usageTrendsMeasurements.pageInfo,
107
+ };
108
+ }));
109
+ }
110
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/analytics/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../../tools/types.js';
3
+ export declare function registerAuditEventTools(server: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,112 @@
1
+ import { z } from 'zod';
2
+ import { GroupIdArg, PaginationArgs, ProjectIdArg } from '../../shared/args.js';
3
+ import { safe } from '../../shared/handlers.js';
4
+ import { resolveGroupId, resolveProjectId } from '../../shared/ids.js';
5
+ const AuditDateRange = {
6
+ created_after: z.string().optional().describe('ISO 8601'),
7
+ created_before: z.string().optional(),
8
+ };
9
+ export function registerAuditEventTools(server, ctx) {
10
+ server.tool('audit_event_list_instance', 'List instance-level audit events (admin only).', {
11
+ entity_type: z.enum(['User', 'Group', 'Project']).optional(),
12
+ entity_id: z.number().int().optional(),
13
+ ...AuditDateRange,
14
+ ...PaginationArgs,
15
+ }, async (args) => safe(async () => {
16
+ const res = await ctx.rest.request({ path: '/audit_events', query: args });
17
+ return res.data;
18
+ }));
19
+ server.tool('audit_event_get_instance', 'Get a single instance audit event.', { id: z.number().int().positive() }, async (args) => safe(async () => {
20
+ const res = await ctx.rest.request({ path: `/audit_events/${args.id}` });
21
+ return res.data;
22
+ }));
23
+ server.tool('audit_event_list_group', 'List group-level audit events.', { ...GroupIdArg, ...AuditDateRange, ...PaginationArgs }, async (args) => safe(async () => {
24
+ const groupId = resolveGroupId(ctx.config, args.group_id);
25
+ const { group_id: _g, ...rest } = args;
26
+ const res = await ctx.rest.request({
27
+ path: `/groups/${groupId}/audit_events`,
28
+ query: rest,
29
+ });
30
+ return res.data;
31
+ }));
32
+ server.tool('audit_event_get_group', 'Get a single group audit event.', { ...GroupIdArg, id: z.number().int().positive() }, async (args) => safe(async () => {
33
+ const groupId = resolveGroupId(ctx.config, args.group_id);
34
+ const res = await ctx.rest.request({
35
+ path: `/groups/${groupId}/audit_events/${args.id}`,
36
+ });
37
+ return res.data;
38
+ }));
39
+ server.tool('audit_event_list_project', 'List project-level audit events.', { ...ProjectIdArg, ...AuditDateRange, ...PaginationArgs }, async (args) => safe(async () => {
40
+ const projectId = resolveProjectId(ctx.config, args.project_id);
41
+ const { project_id: _p, ...rest } = args;
42
+ const res = await ctx.rest.request({
43
+ path: `/projects/${projectId}/audit_events`,
44
+ query: rest,
45
+ });
46
+ return res.data;
47
+ }));
48
+ server.tool('audit_event_get_project', 'Get a single project audit event.', { ...ProjectIdArg, id: z.number().int().positive() }, async (args) => safe(async () => {
49
+ const projectId = resolveProjectId(ctx.config, args.project_id);
50
+ const res = await ctx.rest.request({
51
+ path: `/projects/${projectId}/audit_events/${args.id}`,
52
+ });
53
+ return res.data;
54
+ }));
55
+ // -- Group streaming destinations (HTTP) ------------------------------
56
+ server.tool('audit_streaming_destination_list', 'List HTTP audit-event streaming destinations for a group (Ultimate).', { ...GroupIdArg, ...PaginationArgs }, async (args) => safe(async () => {
57
+ const groupId = resolveGroupId(ctx.config, args.group_id);
58
+ const { group_id: _g, ...rest } = args;
59
+ const res = await ctx.rest.request({
60
+ path: `/groups/${groupId}/audit_events/streaming/destinations`,
61
+ query: rest,
62
+ });
63
+ return res.data;
64
+ }));
65
+ server.tool('audit_streaming_destination_get', 'Get a single streaming destination.', { ...GroupIdArg, destination_id: z.number().int().positive() }, async (args) => safe(async () => {
66
+ const groupId = resolveGroupId(ctx.config, args.group_id);
67
+ const res = await ctx.rest.request({
68
+ path: `/groups/${groupId}/audit_events/streaming/destinations/${args.destination_id}`,
69
+ });
70
+ return res.data;
71
+ }));
72
+ server.tool('audit_streaming_destination_create', 'Add an HTTP destination that receives audit events for a group.', {
73
+ ...GroupIdArg,
74
+ url: z.string().url(),
75
+ verification_token: z.string().optional().describe('At least 16 chars.'),
76
+ name: z.string().optional(),
77
+ }, async (args) => safe(async () => {
78
+ const groupId = resolveGroupId(ctx.config, args.group_id);
79
+ const { group_id: _g, ...body } = args;
80
+ const res = await ctx.rest.request({
81
+ method: 'POST',
82
+ path: `/groups/${groupId}/audit_events/streaming/destinations`,
83
+ body,
84
+ });
85
+ return res.data;
86
+ }));
87
+ server.tool('audit_streaming_destination_update', 'Update a streaming destination.', {
88
+ ...GroupIdArg,
89
+ destination_id: z.number().int().positive(),
90
+ url: z.string().url().optional(),
91
+ verification_token: z.string().optional(),
92
+ name: z.string().optional(),
93
+ }, async (args) => safe(async () => {
94
+ const groupId = resolveGroupId(ctx.config, args.group_id);
95
+ const { group_id: _g, destination_id, ...body } = args;
96
+ const res = await ctx.rest.request({
97
+ method: 'PUT',
98
+ path: `/groups/${groupId}/audit_events/streaming/destinations/${destination_id}`,
99
+ body,
100
+ });
101
+ return res.data;
102
+ }));
103
+ server.tool('audit_streaming_destination_delete', 'Delete a streaming destination.', { ...GroupIdArg, destination_id: z.number().int().positive() }, async (args) => safe(async () => {
104
+ const groupId = resolveGroupId(ctx.config, args.group_id);
105
+ const res = await ctx.rest.request({
106
+ method: 'DELETE',
107
+ path: `/groups/${groupId}/audit_events/streaming/destinations/${args.destination_id}`,
108
+ });
109
+ return res.data ?? { ok: true };
110
+ }));
111
+ }
112
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/audit_events/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../../tools/types.js';
3
+ export declare function registerBoardTools(server: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,46 @@
1
+ import { z } from 'zod';
2
+ import { GroupIdArg, IdOrPath, ProjectIdArg } from '../../shared/args.js';
3
+ import { safe } from '../../shared/handlers.js';
4
+ import { resolveGroupId, resolveProjectId } from '../../shared/ids.js';
5
+ function boardsRoot(scope, scopeId) {
6
+ return `/${scope === 'project' ? 'projects' : 'groups'}/${scopeId}/boards`;
7
+ }
8
+ export function registerBoardTools(server, ctx) {
9
+ server.tool('board_list_project', 'List issue boards for a project.', { ...ProjectIdArg }, async (args) => safe(async () => {
10
+ const projectId = resolveProjectId(ctx.config, args.project_id);
11
+ const res = await ctx.rest.request({ path: boardsRoot('project', projectId) });
12
+ return res.data;
13
+ }));
14
+ server.tool('board_list_group', 'List issue boards for a group.', { ...GroupIdArg }, async (args) => safe(async () => {
15
+ const groupId = resolveGroupId(ctx.config, args.group_id);
16
+ const res = await ctx.rest.request({ path: boardsRoot('group', groupId) });
17
+ return res.data;
18
+ }));
19
+ server.tool('board_get', 'Get a single board.', {
20
+ scope: z.enum(['project', 'group']),
21
+ scope_id: IdOrPath.optional(),
22
+ board_id: z.number().int().positive(),
23
+ }, async (args) => safe(async () => {
24
+ const scopeId = args.scope === 'project'
25
+ ? resolveProjectId(ctx.config, args.scope_id)
26
+ : resolveGroupId(ctx.config, args.scope_id);
27
+ const res = await ctx.rest.request({
28
+ path: `${boardsRoot(args.scope, scopeId)}/${args.board_id}`,
29
+ });
30
+ return res.data;
31
+ }));
32
+ server.tool('board_list_lists', 'List the columns (board lists) on a board.', {
33
+ scope: z.enum(['project', 'group']),
34
+ scope_id: IdOrPath.optional(),
35
+ board_id: z.number().int().positive(),
36
+ }, async (args) => safe(async () => {
37
+ const scopeId = args.scope === 'project'
38
+ ? resolveProjectId(ctx.config, args.scope_id)
39
+ : resolveGroupId(ctx.config, args.scope_id);
40
+ const res = await ctx.rest.request({
41
+ path: `${boardsRoot(args.scope, scopeId)}/${args.board_id}/lists`,
42
+ });
43
+ return res.data;
44
+ }));
45
+ }
46
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/boards/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../../tools/types.js';
3
+ export declare function registerBranchTools(server: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,122 @@
1
+ import { z } from 'zod';
2
+ import { PaginationArgs, ProjectIdArg } from '../../shared/args.js';
3
+ import { safe } from '../../shared/handlers.js';
4
+ import { resolveProjectId } from '../../shared/ids.js';
5
+ const AccessLevel = z.number().int().describe('GitLab access level: 0=None, 30=Developer, 40=Maintainer, 60=Admin.');
6
+ const AccessRule = z.object({
7
+ user_id: z.number().int().optional(),
8
+ group_id: z.number().int().optional(),
9
+ access_level: AccessLevel.optional(),
10
+ });
11
+ export function registerBranchTools(server, ctx) {
12
+ server.tool('branch_list', 'List branches in a project repository.', {
13
+ ...ProjectIdArg,
14
+ search: z.string().optional().describe('Substring search (^prefix for prefix-match).'),
15
+ regex: z.string().optional(),
16
+ ...PaginationArgs,
17
+ }, async (args) => safe(async () => {
18
+ const projectId = resolveProjectId(ctx.config, args.project_id);
19
+ const { project_id: _p, ...rest } = args;
20
+ const res = await ctx.rest.request({
21
+ path: `/projects/${projectId}/repository/branches`,
22
+ query: rest,
23
+ });
24
+ return res.data;
25
+ }));
26
+ server.tool('branch_get', 'Get a single branch by name.', { ...ProjectIdArg, branch: z.string() }, async (args) => safe(async () => {
27
+ const projectId = resolveProjectId(ctx.config, args.project_id);
28
+ const res = await ctx.rest.request({
29
+ path: `/projects/${projectId}/repository/branches/${encodeURIComponent(args.branch)}`,
30
+ });
31
+ return res.data;
32
+ }));
33
+ server.tool('branch_create', 'Create a new branch from a ref.', { ...ProjectIdArg, branch: z.string(), ref: z.string() }, async (args) => safe(async () => {
34
+ const projectId = resolveProjectId(ctx.config, args.project_id);
35
+ const res = await ctx.rest.request({
36
+ method: 'POST',
37
+ path: `/projects/${projectId}/repository/branches`,
38
+ body: { branch: args.branch, ref: args.ref },
39
+ });
40
+ return res.data;
41
+ }));
42
+ server.tool('branch_delete', 'Delete a branch.', { ...ProjectIdArg, branch: z.string() }, async (args) => safe(async () => {
43
+ const projectId = resolveProjectId(ctx.config, args.project_id);
44
+ const res = await ctx.rest.request({
45
+ method: 'DELETE',
46
+ path: `/projects/${projectId}/repository/branches/${encodeURIComponent(args.branch)}`,
47
+ });
48
+ return res.data ?? { ok: true };
49
+ }));
50
+ server.tool('branch_delete_merged', 'Delete all merged branches (kept: default + protected). Returns 202 (async).', { ...ProjectIdArg }, async (args) => safe(async () => {
51
+ const projectId = resolveProjectId(ctx.config, args.project_id);
52
+ const res = await ctx.rest.request({
53
+ method: 'DELETE',
54
+ path: `/projects/${projectId}/repository/merged_branches`,
55
+ });
56
+ return res.data ?? { ok: true };
57
+ }));
58
+ server.tool('protected_branch_list', 'List protected branches.', { ...ProjectIdArg, search: z.string().optional(), ...PaginationArgs }, async (args) => safe(async () => {
59
+ const projectId = resolveProjectId(ctx.config, args.project_id);
60
+ const { project_id: _p, ...rest } = args;
61
+ const res = await ctx.rest.request({
62
+ path: `/projects/${projectId}/protected_branches`,
63
+ query: rest,
64
+ });
65
+ return res.data;
66
+ }));
67
+ server.tool('protected_branch_get', 'Get a protected branch by name (supports wildcards like "release/*").', { ...ProjectIdArg, name: z.string() }, async (args) => safe(async () => {
68
+ const projectId = resolveProjectId(ctx.config, args.project_id);
69
+ const res = await ctx.rest.request({
70
+ path: `/projects/${projectId}/protected_branches/${encodeURIComponent(args.name)}`,
71
+ });
72
+ return res.data;
73
+ }));
74
+ server.tool('protected_branch_protect', 'Protect a branch (or wildcard) with push/merge rules.', {
75
+ ...ProjectIdArg,
76
+ name: z.string(),
77
+ push_access_level: AccessLevel.optional(),
78
+ merge_access_level: AccessLevel.optional(),
79
+ unprotect_access_level: AccessLevel.optional(),
80
+ allowed_to_push: z.array(AccessRule).optional(),
81
+ allowed_to_merge: z.array(AccessRule).optional(),
82
+ allowed_to_unprotect: z.array(AccessRule).optional(),
83
+ allow_force_push: z.boolean().optional(),
84
+ code_owner_approval_required: z.boolean().optional(),
85
+ }, async (args) => safe(async () => {
86
+ const projectId = resolveProjectId(ctx.config, args.project_id);
87
+ const { project_id: _p, ...body } = args;
88
+ const res = await ctx.rest.request({
89
+ method: 'POST',
90
+ path: `/projects/${projectId}/protected_branches`,
91
+ body,
92
+ });
93
+ return res.data;
94
+ }));
95
+ server.tool('protected_branch_update', 'Update an existing protected branch rule.', {
96
+ ...ProjectIdArg,
97
+ name: z.string(),
98
+ allowed_to_push: z.array(AccessRule).optional(),
99
+ allowed_to_merge: z.array(AccessRule).optional(),
100
+ allowed_to_unprotect: z.array(AccessRule).optional(),
101
+ allow_force_push: z.boolean().optional(),
102
+ code_owner_approval_required: z.boolean().optional(),
103
+ }, async (args) => safe(async () => {
104
+ const projectId = resolveProjectId(ctx.config, args.project_id);
105
+ const { project_id: _p, name, ...body } = args;
106
+ const res = await ctx.rest.request({
107
+ method: 'PATCH',
108
+ path: `/projects/${projectId}/protected_branches/${encodeURIComponent(name)}`,
109
+ body,
110
+ });
111
+ return res.data;
112
+ }));
113
+ server.tool('protected_branch_unprotect', 'Remove protection from a branch.', { ...ProjectIdArg, name: z.string() }, async (args) => safe(async () => {
114
+ const projectId = resolveProjectId(ctx.config, args.project_id);
115
+ const res = await ctx.rest.request({
116
+ method: 'DELETE',
117
+ path: `/projects/${projectId}/protected_branches/${encodeURIComponent(args.name)}`,
118
+ });
119
+ return res.data ?? { ok: true };
120
+ }));
121
+ }
122
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/branches/tools.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare const CATALOG_RESOURCES_LIST = "\n query CiCatalogResources(\n $first: Int\n $after: String\n $scope: CiCatalogResourceScope\n $search: String\n $topic: String\n $sort: CiCatalogResourceSort\n ) {\n ciCatalogResources(\n first: $first\n after: $after\n scope: $scope\n search: $search\n topic: $topic\n sort: $sort\n ) {\n pageInfo {\n endCursor\n hasNextPage\n }\n nodes {\n id\n name\n fullPath\n description\n verificationLevel\n starCount\n topics\n webPath\n latestVersion {\n name\n path\n createdAt\n }\n }\n }\n }\n";
2
+ export declare const CATALOG_RESOURCE_GET = "\n query CiCatalogResource($fullPath: ID!) {\n ciCatalogResource(fullPath: $fullPath) {\n id\n name\n fullPath\n description\n verificationLevel\n starCount\n topics\n webPath\n readmeHtml\n versions {\n nodes {\n name\n path\n createdAt\n released\n }\n }\n }\n }\n";
@@ -0,0 +1,63 @@
1
+ export const CATALOG_RESOURCES_LIST = /* GraphQL */ `
2
+ query CiCatalogResources(
3
+ $first: Int
4
+ $after: String
5
+ $scope: CiCatalogResourceScope
6
+ $search: String
7
+ $topic: String
8
+ $sort: CiCatalogResourceSort
9
+ ) {
10
+ ciCatalogResources(
11
+ first: $first
12
+ after: $after
13
+ scope: $scope
14
+ search: $search
15
+ topic: $topic
16
+ sort: $sort
17
+ ) {
18
+ pageInfo {
19
+ endCursor
20
+ hasNextPage
21
+ }
22
+ nodes {
23
+ id
24
+ name
25
+ fullPath
26
+ description
27
+ verificationLevel
28
+ starCount
29
+ topics
30
+ webPath
31
+ latestVersion {
32
+ name
33
+ path
34
+ createdAt
35
+ }
36
+ }
37
+ }
38
+ }
39
+ `;
40
+ export const CATALOG_RESOURCE_GET = /* GraphQL */ `
41
+ query CiCatalogResource($fullPath: ID!) {
42
+ ciCatalogResource(fullPath: $fullPath) {
43
+ id
44
+ name
45
+ fullPath
46
+ description
47
+ verificationLevel
48
+ starCount
49
+ topics
50
+ webPath
51
+ readmeHtml
52
+ versions {
53
+ nodes {
54
+ name
55
+ path
56
+ createdAt
57
+ released
58
+ }
59
+ }
60
+ }
61
+ }
62
+ `;
63
+ //# sourceMappingURL=queries.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/groups/ci_catalog/queries.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCnD,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;CAsBjD,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../../tools/types.js';
3
+ export declare function registerCiCatalogTools(server: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,45 @@
1
+ import { z } from 'zod';
2
+ import { safe } from '../../shared/handlers.js';
3
+ import { CATALOG_RESOURCES_LIST, CATALOG_RESOURCE_GET } from './queries.js';
4
+ export function registerCiCatalogTools(server, ctx) {
5
+ server.tool('catalog_resource_list', 'List CI Catalog resources (reusable pipelines / components).', {
6
+ first: z.number().int().positive().max(100).optional(),
7
+ after: z.string().optional(),
8
+ scope: z.enum(['ALL', 'NAMESPACES']).optional(),
9
+ search: z.string().optional(),
10
+ topic: z.string().optional(),
11
+ sort: z
12
+ .enum([
13
+ 'NAME_ASC',
14
+ 'NAME_DESC',
15
+ 'CREATED_ASC',
16
+ 'CREATED_DESC',
17
+ 'LATEST_RELEASED_AT_ASC',
18
+ 'LATEST_RELEASED_AT_DESC',
19
+ 'USAGE_COUNT_ASC',
20
+ 'USAGE_COUNT_DESC',
21
+ ])
22
+ .optional(),
23
+ }, async (args) => safe(async () => {
24
+ const { first, ...rest } = args;
25
+ const data = await ctx.graphql.query({
26
+ query: CATALOG_RESOURCES_LIST,
27
+ variables: { first: first ?? 20, ...rest },
28
+ });
29
+ return {
30
+ items: data.ciCatalogResources.nodes,
31
+ page_info: data.ciCatalogResources.pageInfo,
32
+ };
33
+ }));
34
+ server.tool('catalog_resource_get', 'Get a single CI Catalog resource by full path.', { full_path: z.string().describe('e.g. "group/component-project"') }, async (args) => safe(async () => {
35
+ const data = await ctx.graphql.query({
36
+ query: CATALOG_RESOURCE_GET,
37
+ variables: { fullPath: args.full_path },
38
+ });
39
+ if (!data.ciCatalogResource) {
40
+ throw new Error(`CI catalog resource "${args.full_path}" not found.`);
41
+ }
42
+ return data.ciCatalogResource;
43
+ }));
44
+ }
45
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/ci_catalog/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAEhD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE5E,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,GAAgB;IACxE,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,8DAA8D,EAC9D;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC;YACJ,UAAU;YACV,WAAW;YACX,aAAa;YACb,cAAc;YACd,wBAAwB;YACxB,yBAAyB;YACzB,iBAAiB;YACjB,kBAAkB;SACnB,CAAC;aACD,QAAQ,EAAE;KACd,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAKjC;YACD,KAAK,EAAE,sBAAsB;YAC7B,SAAS,EAAE,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE;SAC3C,CAAC,CAAC;QACH,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,kBAAkB,CAAC,KAAK;YACpC,SAAS,EAAE,IAAI,CAAC,kBAAkB,CAAC,QAAQ;SAC5C,CAAC;IACJ,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,gDAAgD,EAChD,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC,EAAE,EACpE,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAwC;YAC1E,KAAK,EAAE,oBAAoB;YAC3B,SAAS,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE;SACxC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,SAAS,cAAc,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../../tools/types.js';
3
+ export declare function registerCiLintTools(server: McpServer, ctx: ToolContext): void;
@@ -0,0 +1,36 @@
1
+ import { z } from 'zod';
2
+ import { ProjectIdArg } from '../../shared/args.js';
3
+ import { safe } from '../../shared/handlers.js';
4
+ import { resolveProjectId } from '../../shared/ids.js';
5
+ export function registerCiLintTools(server, ctx) {
6
+ server.tool('ci_lint', 'Validate a .gitlab-ci.yml without a project context. Returns { valid, errors, warnings, merged_yaml?, jobs? }.', {
7
+ content: z.string().describe('Full YAML content to validate.'),
8
+ include_merged_yaml: z.boolean().optional(),
9
+ include_jobs: z.boolean().optional(),
10
+ }, async (args) => safe(async () => {
11
+ const res = await ctx.rest.request({
12
+ method: 'POST',
13
+ path: '/ci/lint',
14
+ body: args,
15
+ });
16
+ return res.data;
17
+ }));
18
+ server.tool('ci_lint_project', 'Validate a CI config with a project\'s include context. If content is omitted, the project\'s current .gitlab-ci.yml at `ref` is linted (dry_run).', {
19
+ ...ProjectIdArg,
20
+ content: z.string().optional(),
21
+ dry_run: z.boolean().optional().describe('When true, lints the project\'s current file at ref.'),
22
+ ref: z.string().optional().describe('Ref to lint against (default: project default branch).'),
23
+ include_merged_yaml: z.boolean().optional(),
24
+ include_jobs: z.boolean().optional(),
25
+ }, async (args) => safe(async () => {
26
+ const projectId = resolveProjectId(ctx.config, args.project_id);
27
+ const { project_id: _p, ...body } = args;
28
+ const res = await ctx.rest.request({
29
+ method: 'POST',
30
+ path: `/projects/${projectId}/ci/lint`,
31
+ body,
32
+ });
33
+ return res.data;
34
+ }));
35
+ }
36
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/groups/ci_lint/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,GAAgB;IACrE,MAAM,CAAC,IAAI,CACT,SAAS,EACT,gHAAgH,EAChH;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC9D,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC3C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;YACjC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,oJAAoJ,EACpJ;QACE,GAAG,YAAY;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;QAChG,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;QAC7F,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC3C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACrC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,IAAI,CAAC,KAAK,IAAI,EAAE;QACd,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAChE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;YACjC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,aAAa,SAAS,UAAU;YACtC,IAAI;SACL,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC,CAAC,CACL,CAAC;AACJ,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { ToolContext } from '../../tools/types.js';
3
+ export declare function registerCiVariableTools(server: McpServer, ctx: ToolContext): void;