cucumberstudio-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 (130) hide show
  1. package/.env.example +36 -0
  2. package/.github/workflows/pr-checks.yml +41 -0
  3. package/.github/workflows/release.yml +194 -0
  4. package/.prettierignore +26 -0
  5. package/.prettierrc +14 -0
  6. package/CLAUDE.md +140 -0
  7. package/Dockerfile +50 -0
  8. package/Dockerfile.dev +31 -0
  9. package/LICENSE +21 -0
  10. package/README.md +395 -0
  11. package/build/api/client.d.ts +49 -0
  12. package/build/api/client.d.ts.map +1 -0
  13. package/build/api/client.js +204 -0
  14. package/build/api/client.js.map +1 -0
  15. package/build/api/types.d.ts +113 -0
  16. package/build/api/types.d.ts.map +1 -0
  17. package/build/api/types.js +2 -0
  18. package/build/api/types.js.map +1 -0
  19. package/build/config/settings.d.ts +123 -0
  20. package/build/config/settings.d.ts.map +1 -0
  21. package/build/config/settings.js +97 -0
  22. package/build/config/settings.js.map +1 -0
  23. package/build/constants.d.ts +16 -0
  24. package/build/constants.d.ts.map +1 -0
  25. package/build/constants.js +24 -0
  26. package/build/constants.js.map +1 -0
  27. package/build/generated/version.d.ts +3 -0
  28. package/build/generated/version.d.ts.map +1 -0
  29. package/build/generated/version.js +5 -0
  30. package/build/generated/version.js.map +1 -0
  31. package/build/index.d.ts +3 -0
  32. package/build/index.d.ts.map +1 -0
  33. package/build/index.js +81 -0
  34. package/build/index.js.map +1 -0
  35. package/build/mcp-server.d.ts +6 -0
  36. package/build/mcp-server.d.ts.map +1 -0
  37. package/build/mcp-server.js +263 -0
  38. package/build/mcp-server.js.map +1 -0
  39. package/build/tools/action-words.d.ts +18 -0
  40. package/build/tools/action-words.d.ts.map +1 -0
  41. package/build/tools/action-words.js +191 -0
  42. package/build/tools/action-words.js.map +1 -0
  43. package/build/tools/projects.d.ts +19 -0
  44. package/build/tools/projects.d.ts.map +1 -0
  45. package/build/tools/projects.js +123 -0
  46. package/build/tools/projects.js.map +1 -0
  47. package/build/tools/scenarios.d.ts +18 -0
  48. package/build/tools/scenarios.d.ts.map +1 -0
  49. package/build/tools/scenarios.js +194 -0
  50. package/build/tools/scenarios.js.map +1 -0
  51. package/build/tools/test-runs.d.ts +21 -0
  52. package/build/tools/test-runs.d.ts.map +1 -0
  53. package/build/tools/test-runs.js +324 -0
  54. package/build/tools/test-runs.js.map +1 -0
  55. package/build/transports/http.d.ts +38 -0
  56. package/build/transports/http.d.ts.map +1 -0
  57. package/build/transports/http.js +381 -0
  58. package/build/transports/http.js.map +1 -0
  59. package/build/transports/index.d.ts +22 -0
  60. package/build/transports/index.d.ts.map +1 -0
  61. package/build/transports/index.js +10 -0
  62. package/build/transports/index.js.map +1 -0
  63. package/build/transports/stdio.d.ts +13 -0
  64. package/build/transports/stdio.d.ts.map +1 -0
  65. package/build/transports/stdio.js +24 -0
  66. package/build/transports/stdio.js.map +1 -0
  67. package/build/utils/errors.d.ts +10 -0
  68. package/build/utils/errors.d.ts.map +1 -0
  69. package/build/utils/errors.js +35 -0
  70. package/build/utils/errors.js.map +1 -0
  71. package/build/utils/logger-constants.d.ts +15 -0
  72. package/build/utils/logger-constants.d.ts.map +1 -0
  73. package/build/utils/logger-constants.js +16 -0
  74. package/build/utils/logger-constants.js.map +1 -0
  75. package/build/utils/logger.d.ts +55 -0
  76. package/build/utils/logger.d.ts.map +1 -0
  77. package/build/utils/logger.js +113 -0
  78. package/build/utils/logger.js.map +1 -0
  79. package/build/utils/validation.d.ts +89 -0
  80. package/build/utils/validation.d.ts.map +1 -0
  81. package/build/utils/validation.js +78 -0
  82. package/build/utils/validation.js.map +1 -0
  83. package/docker-compose.yml +20 -0
  84. package/eslint.config.js +97 -0
  85. package/package.json +92 -0
  86. package/scripts/generate-version.js +31 -0
  87. package/src/api/client.ts +286 -0
  88. package/src/api/types.ts +137 -0
  89. package/src/config/settings.ts +113 -0
  90. package/src/constants.ts +29 -0
  91. package/src/index.ts +99 -0
  92. package/src/mcp-server.ts +342 -0
  93. package/src/tools/action-words.ts +240 -0
  94. package/src/tools/projects.ts +144 -0
  95. package/src/tools/scenarios.ts +231 -0
  96. package/src/tools/test-runs.ts +400 -0
  97. package/src/transports/http.ts +467 -0
  98. package/src/transports/index.ts +26 -0
  99. package/src/transports/stdio.ts +28 -0
  100. package/src/utils/errors.ts +45 -0
  101. package/src/utils/logger-constants.ts +18 -0
  102. package/src/utils/logger.ts +150 -0
  103. package/src/utils/validation.ts +94 -0
  104. package/test/api/client-with-msw.test.ts +122 -0
  105. package/test/api/client.test.ts +326 -0
  106. package/test/api/types.test.ts +88 -0
  107. package/test/config/settings.test.ts +204 -0
  108. package/test/mocks/data/action-words.ts +40 -0
  109. package/test/mocks/data/index.ts +13 -0
  110. package/test/mocks/data/projects.ts +38 -0
  111. package/test/mocks/data/scenarios.ts +53 -0
  112. package/test/mocks/data/test-runs.ts +101 -0
  113. package/test/mocks/handlers/action-words.ts +52 -0
  114. package/test/mocks/handlers/index.ts +10 -0
  115. package/test/mocks/handlers/projects.ts +45 -0
  116. package/test/mocks/handlers/scenarios.ts +72 -0
  117. package/test/mocks/handlers/test-runs.ts +106 -0
  118. package/test/mocks/server.ts +26 -0
  119. package/test/setup/vitest.setup.ts +18 -0
  120. package/test/tools/coverage-boost.test.ts +252 -0
  121. package/test/tools/projects.test.ts +290 -0
  122. package/test/tools/tools-basic.test.ts +146 -0
  123. package/test/transports/http-basic.test.ts +87 -0
  124. package/test/transports/http-simple.test.ts +33 -0
  125. package/test/transports/stdio.test.ts +73 -0
  126. package/test/utils/errors.test.ts +117 -0
  127. package/test/utils/validation.test.ts +261 -0
  128. package/tsconfig.build.json +8 -0
  129. package/tsconfig.json +27 -0
  130. package/vitest.config.ts +43 -0
@@ -0,0 +1,263 @@
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { z } from 'zod';
3
+ import { CucumberStudioApiClient } from './api/client.js';
4
+ import { configManager } from './config/settings.js';
5
+ import { SERVER_NAME, SERVER_VERSION, LOG_PREFIX } from './constants.js';
6
+ import { ActionWordTools } from './tools/action-words.js';
7
+ import { ProjectTools } from './tools/projects.js';
8
+ import { ScenarioTools } from './tools/scenarios.js';
9
+ import { TestRunTools } from './tools/test-runs.js';
10
+ import { StderrLogger, getLogLevel } from './utils/logger.js';
11
+ import { validateEnvironment } from './utils/validation.js';
12
+ /**
13
+ * Create and configure a new CucumberStudio MCP Server
14
+ */
15
+ export function createCucumberStudioMcpServer() {
16
+ const server = new McpServer({
17
+ name: SERVER_NAME,
18
+ version: SERVER_VERSION,
19
+ });
20
+ // Initialize server tools asynchronously
21
+ initializeServerTools(server).catch((error) => {
22
+ console.error('❌ Failed to initialize server tools:', error);
23
+ });
24
+ return server;
25
+ }
26
+ /**
27
+ * Initialize all tools and register them with the server
28
+ */
29
+ async function initializeServerTools(server) {
30
+ // Validate environment variables
31
+ validateEnvironment();
32
+ // Load configuration
33
+ const config = configManager.loadFromEnvironment();
34
+ // Initialize API client
35
+ const apiLogger = new StderrLogger({ level: getLogLevel(), prefix: LOG_PREFIX });
36
+ const apiClient = new CucumberStudioApiClient(config, apiLogger);
37
+ // Initialize tool classes
38
+ const projectTools = new ProjectTools(apiClient);
39
+ const scenarioTools = new ScenarioTools(apiClient);
40
+ const actionWordTools = new ActionWordTools(apiClient);
41
+ const testRunTools = new TestRunTools(apiClient);
42
+ // Register all tools
43
+ registerProjectTools(server, projectTools);
44
+ registerScenarioTools(server, scenarioTools);
45
+ registerActionWordTools(server, actionWordTools);
46
+ registerTestRunTools(server, testRunTools);
47
+ console.error('✅ CucumberStudio MCP Server tools initialized');
48
+ }
49
+ /**
50
+ * Register project-related tools
51
+ */
52
+ function registerProjectTools(server, projectTools) {
53
+ server.registerTool('cucumberstudio_list_projects', {
54
+ description: 'List all projects accessible to the authenticated user',
55
+ inputSchema: {
56
+ pagination: z
57
+ .object({
58
+ page: z.number().min(1).optional(),
59
+ pageSize: z.number().min(1).max(100).optional(),
60
+ })
61
+ .optional(),
62
+ filter: z
63
+ .object({
64
+ name: z.string().optional(),
65
+ })
66
+ .optional(),
67
+ },
68
+ }, async (args) => {
69
+ return await projectTools.listProjects(args || {});
70
+ });
71
+ server.registerTool('cucumberstudio_get_project', {
72
+ description: 'Get detailed information about a specific project',
73
+ inputSchema: {
74
+ projectId: z.string(),
75
+ },
76
+ }, async (args) => {
77
+ return await projectTools.getProject(args);
78
+ });
79
+ }
80
+ /**
81
+ * Register scenario-related tools
82
+ */
83
+ function registerScenarioTools(server, scenarioTools) {
84
+ server.registerTool('cucumberstudio_list_scenarios', {
85
+ description: 'List all scenarios in a project',
86
+ inputSchema: {
87
+ projectId: z.string(),
88
+ pagination: z
89
+ .object({
90
+ page: z.number().min(1).optional(),
91
+ pageSize: z.number().min(1).max(100).optional(),
92
+ })
93
+ .optional(),
94
+ filter: z
95
+ .object({
96
+ name: z.string().optional(),
97
+ tags: z.string().optional(),
98
+ })
99
+ .optional(),
100
+ },
101
+ }, async (args) => {
102
+ return await scenarioTools.listScenarios(args);
103
+ });
104
+ server.registerTool('cucumberstudio_get_scenario', {
105
+ description: 'Get detailed information about a specific scenario',
106
+ inputSchema: {
107
+ projectId: z.string(),
108
+ scenarioId: z.string(),
109
+ },
110
+ }, async (args) => {
111
+ return await scenarioTools.getScenario(args);
112
+ });
113
+ server.registerTool('cucumberstudio_find_scenarios_by_tags', {
114
+ description: 'Find scenarios by tags in a project',
115
+ inputSchema: {
116
+ projectId: z.string(),
117
+ tags: z.string().min(1),
118
+ pagination: z
119
+ .object({
120
+ page: z.number().min(1).optional(),
121
+ pageSize: z.number().min(1).max(100).optional(),
122
+ })
123
+ .optional(),
124
+ },
125
+ }, async (args) => {
126
+ return await scenarioTools.findScenariosByTags(args);
127
+ });
128
+ }
129
+ /**
130
+ * Register action word-related tools
131
+ */
132
+ function registerActionWordTools(server, actionWordTools) {
133
+ server.registerTool('cucumberstudio_list_action_words', {
134
+ description: 'List all action words (reusable test steps) in a project',
135
+ inputSchema: {
136
+ projectId: z.string(),
137
+ pagination: z
138
+ .object({
139
+ page: z.number().min(1).optional(),
140
+ pageSize: z.number().min(1).max(100).optional(),
141
+ })
142
+ .optional(),
143
+ filter: z
144
+ .object({
145
+ name: z.string().optional(),
146
+ tags: z.string().optional(),
147
+ })
148
+ .optional(),
149
+ },
150
+ }, async (args) => {
151
+ return await actionWordTools.listActionWords(args);
152
+ });
153
+ server.registerTool('cucumberstudio_get_action_word', {
154
+ description: 'Get detailed information about a specific action word',
155
+ inputSchema: {
156
+ projectId: z.string(),
157
+ actionWordId: z.string(),
158
+ },
159
+ }, async (args) => {
160
+ return await actionWordTools.getActionWord(args);
161
+ });
162
+ server.registerTool('cucumberstudio_find_action_words_by_tags', {
163
+ description: 'Find action words by tags in a project',
164
+ inputSchema: {
165
+ projectId: z.string(),
166
+ tags: z.string().min(1),
167
+ pagination: z
168
+ .object({
169
+ page: z.number().min(1).optional(),
170
+ pageSize: z.number().min(1).max(100).optional(),
171
+ })
172
+ .optional(),
173
+ },
174
+ }, async (args) => {
175
+ return await actionWordTools.findActionWordsByTags(args);
176
+ });
177
+ }
178
+ /**
179
+ * Register test run-related tools
180
+ */
181
+ function registerTestRunTools(server, testRunTools) {
182
+ server.registerTool('cucumberstudio_list_test_runs', {
183
+ description: 'List all test runs in a project',
184
+ inputSchema: {
185
+ projectId: z.string(),
186
+ pagination: z
187
+ .object({
188
+ page: z.number().min(1).optional(),
189
+ pageSize: z.number().min(1).max(100).optional(),
190
+ })
191
+ .optional(),
192
+ filter: z
193
+ .object({
194
+ name: z.string().optional(),
195
+ })
196
+ .optional(),
197
+ },
198
+ }, async (args) => {
199
+ return await testRunTools.listTestRuns(args);
200
+ });
201
+ server.registerTool('cucumberstudio_get_test_run', {
202
+ description: 'Get detailed information about a specific test run',
203
+ inputSchema: {
204
+ projectId: z.string(),
205
+ testRunId: z.string(),
206
+ },
207
+ }, async (args) => {
208
+ return await testRunTools.getTestRun(args);
209
+ });
210
+ server.registerTool('cucumberstudio_get_test_executions', {
211
+ description: 'Get test executions (individual test results) for a test run',
212
+ inputSchema: {
213
+ projectId: z.string(),
214
+ testRunId: z.string(),
215
+ pagination: z
216
+ .object({
217
+ page: z.number().min(1).optional(),
218
+ pageSize: z.number().min(1).max(100).optional(),
219
+ })
220
+ .optional(),
221
+ },
222
+ }, async (args) => {
223
+ return await testRunTools.getTestExecutions(args);
224
+ });
225
+ server.registerTool('cucumberstudio_list_builds', {
226
+ description: 'List all builds in a project',
227
+ inputSchema: {
228
+ projectId: z.string(),
229
+ pagination: z
230
+ .object({
231
+ page: z.number().min(1).optional(),
232
+ pageSize: z.number().min(1).max(100).optional(),
233
+ })
234
+ .optional(),
235
+ },
236
+ }, async (args) => {
237
+ return await testRunTools.listBuilds(args);
238
+ });
239
+ server.registerTool('cucumberstudio_get_build', {
240
+ description: 'Get detailed information about a specific build',
241
+ inputSchema: {
242
+ projectId: z.string(),
243
+ buildId: z.string(),
244
+ },
245
+ }, async (args) => {
246
+ return await testRunTools.getBuild(args);
247
+ });
248
+ server.registerTool('cucumberstudio_list_execution_environments', {
249
+ description: 'List all execution environments in a project',
250
+ inputSchema: {
251
+ projectId: z.string(),
252
+ pagination: z
253
+ .object({
254
+ page: z.number().min(1).optional(),
255
+ pageSize: z.number().min(1).max(100).optional(),
256
+ })
257
+ .optional(),
258
+ },
259
+ }, async (args) => {
260
+ return await testRunTools.listExecutionEnvironments(args);
261
+ });
262
+ }
263
+ //# sourceMappingURL=mcp-server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ import { Tool, CallToolRequest, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
+ import { CucumberStudioApiClient } from '../api/client.js';
3
+ export declare class ActionWordTools {
4
+ private apiClient;
5
+ constructor(apiClient: CucumberStudioApiClient);
6
+ /**
7
+ * Get all available MCP tools for action words
8
+ */
9
+ getTools(): Tool[];
10
+ /**
11
+ * Handle tool calls for action word-related operations
12
+ */
13
+ handleToolCall(request: CallToolRequest): Promise<CallToolResult>;
14
+ listActionWords(args: unknown): Promise<CallToolResult>;
15
+ getActionWord(args: unknown): Promise<CallToolResult>;
16
+ findActionWordsByTags(args: unknown): Promise<CallToolResult>;
17
+ }
18
+ //# sourceMappingURL=action-words.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"action-words.d.ts","sourceRoot":"","sources":["../../src/tools/action-words.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAAe,MAAM,oCAAoC,CAAA;AAGvG,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAsB1D,qBAAa,eAAe;IACd,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,uBAAuB;IAEtD;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;IAmElB;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAgBjE,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAyCvD,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAyCrD,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;CAwCpE"}
@@ -0,0 +1,191 @@
1
+ import { z } from 'zod';
2
+ import { safeExecute } from '../utils/errors.js';
3
+ import { validateInput, ProjectIdSchema, ActionWordIdSchema, ListParamsSchema, convertToApiParams, } from '../utils/validation.js';
4
+ const FindActionWordsByTagsSchema = z.object({
5
+ projectId: ProjectIdSchema,
6
+ tags: z.string().min(1, 'Tags parameter is required'),
7
+ pagination: z
8
+ .object({
9
+ page: z.number().int().min(1).optional(),
10
+ pageSize: z.number().int().min(1).max(100).optional(),
11
+ })
12
+ .optional(),
13
+ });
14
+ export class ActionWordTools {
15
+ apiClient;
16
+ constructor(apiClient) {
17
+ this.apiClient = apiClient;
18
+ }
19
+ /**
20
+ * Get all available MCP tools for action words
21
+ */
22
+ getTools() {
23
+ return [
24
+ {
25
+ name: 'cucumberstudio_list_action_words',
26
+ description: 'List all action words (reusable test steps) in a project',
27
+ inputSchema: {
28
+ type: 'object',
29
+ properties: {
30
+ projectId: { type: 'string', description: 'The ID of the project' },
31
+ pagination: {
32
+ type: 'object',
33
+ properties: {
34
+ page: { type: 'number', minimum: 1, description: 'Page number' },
35
+ pageSize: { type: 'number', minimum: 1, maximum: 100, description: 'Number of items per page' },
36
+ },
37
+ additionalProperties: false,
38
+ },
39
+ filter: {
40
+ type: 'object',
41
+ properties: {
42
+ name: { type: 'string', description: 'Filter action words by name' },
43
+ tags: { type: 'string', description: 'Filter action words by tags' },
44
+ },
45
+ additionalProperties: false,
46
+ },
47
+ },
48
+ required: ['projectId'],
49
+ additionalProperties: false,
50
+ },
51
+ },
52
+ {
53
+ name: 'cucumberstudio_get_action_word',
54
+ description: 'Get detailed information about a specific action word',
55
+ inputSchema: {
56
+ type: 'object',
57
+ properties: {
58
+ projectId: { type: 'string', description: 'The ID of the project' },
59
+ actionWordId: { type: 'string', description: 'The ID of the action word to retrieve' },
60
+ },
61
+ required: ['projectId', 'actionWordId'],
62
+ additionalProperties: false,
63
+ },
64
+ },
65
+ {
66
+ name: 'cucumberstudio_find_action_words_by_tags',
67
+ description: 'Find action words by tags in a project',
68
+ inputSchema: {
69
+ type: 'object',
70
+ properties: {
71
+ projectId: { type: 'string', description: 'The ID of the project' },
72
+ tags: { type: 'string', description: 'Tags to search for (comma-separated)' },
73
+ pagination: {
74
+ type: 'object',
75
+ properties: {
76
+ page: { type: 'number', minimum: 1, description: 'Page number' },
77
+ pageSize: { type: 'number', minimum: 1, maximum: 100, description: 'Number of items per page' },
78
+ },
79
+ additionalProperties: false,
80
+ },
81
+ },
82
+ required: ['projectId', 'tags'],
83
+ additionalProperties: false,
84
+ },
85
+ },
86
+ ];
87
+ }
88
+ /**
89
+ * Handle tool calls for action word-related operations
90
+ */
91
+ async handleToolCall(request) {
92
+ switch (request.params.name) {
93
+ case 'cucumberstudio_list_action_words':
94
+ return this.listActionWords(request.params.arguments);
95
+ case 'cucumberstudio_get_action_word':
96
+ return this.getActionWord(request.params.arguments);
97
+ case 'cucumberstudio_find_action_words_by_tags':
98
+ return this.findActionWordsByTags(request.params.arguments);
99
+ default:
100
+ throw new Error(`Unknown tool: ${request.params.name}`);
101
+ }
102
+ }
103
+ async listActionWords(args) {
104
+ return safeExecute(async () => {
105
+ const projectId = validateInput(ProjectIdSchema, args?.projectId, 'list_action_words');
106
+ const listParams = validateInput(ListParamsSchema, args, 'list_action_words');
107
+ const apiParams = convertToApiParams(listParams);
108
+ const response = await this.apiClient.getActionWords(projectId, apiParams);
109
+ const actionWords = Array.isArray(response.data) ? response.data : [response.data];
110
+ const actionWordList = actionWords.map((actionWord) => ({
111
+ id: actionWord.id,
112
+ name: actionWord.attributes.name,
113
+ description: actionWord.attributes.description || '',
114
+ definition: actionWord.attributes.definition || '',
115
+ created_at: actionWord.attributes.created_at,
116
+ updated_at: actionWord.attributes.updated_at,
117
+ }));
118
+ return {
119
+ content: [
120
+ {
121
+ type: 'text',
122
+ text: JSON.stringify({
123
+ action_words: actionWordList,
124
+ meta: response.meta || {},
125
+ total_count: actionWordList.length,
126
+ }, null, 2),
127
+ },
128
+ ],
129
+ };
130
+ }, 'listing action words');
131
+ }
132
+ async getActionWord(args) {
133
+ return safeExecute(async () => {
134
+ const projectId = validateInput(ProjectIdSchema, args?.projectId, 'get_action_word');
135
+ const actionWordId = validateInput(ActionWordIdSchema, args?.actionWordId, 'get_action_word');
136
+ const response = await this.apiClient.getActionWord(projectId, actionWordId);
137
+ const actionWord = response.data;
138
+ const actionWordDetails = {
139
+ id: actionWord.id,
140
+ type: actionWord.type,
141
+ name: actionWord.attributes.name,
142
+ description: actionWord.attributes.description || '',
143
+ definition: actionWord.attributes.definition || '',
144
+ created_at: actionWord.attributes.created_at,
145
+ updated_at: actionWord.attributes.updated_at,
146
+ relationships: actionWord.relationships || {},
147
+ };
148
+ return {
149
+ content: [
150
+ {
151
+ type: 'text',
152
+ text: JSON.stringify({
153
+ action_word: actionWordDetails,
154
+ included: response.included || [],
155
+ }, null, 2),
156
+ },
157
+ ],
158
+ };
159
+ }, 'getting action word details');
160
+ }
161
+ async findActionWordsByTags(args) {
162
+ return safeExecute(async () => {
163
+ const { projectId, tags, pagination } = validateInput(FindActionWordsByTagsSchema, args, 'find_action_words_by_tags');
164
+ const apiParams = convertToApiParams({ pagination });
165
+ const response = await this.apiClient.findActionWordsByTag(projectId, tags, apiParams);
166
+ const actionWords = Array.isArray(response.data) ? response.data : [response.data];
167
+ const actionWordList = actionWords.map((actionWord) => ({
168
+ id: actionWord.id,
169
+ name: actionWord.attributes.name,
170
+ description: actionWord.attributes.description || '',
171
+ definition: actionWord.attributes.definition || '',
172
+ created_at: actionWord.attributes.created_at,
173
+ updated_at: actionWord.attributes.updated_at,
174
+ }));
175
+ return {
176
+ content: [
177
+ {
178
+ type: 'text',
179
+ text: JSON.stringify({
180
+ action_words: actionWordList,
181
+ search_tags: tags,
182
+ meta: response.meta || {},
183
+ total_count: actionWordList.length,
184
+ }, null, 2),
185
+ },
186
+ ],
187
+ };
188
+ }, 'finding action words by tags');
189
+ }
190
+ }
191
+ //# sourceMappingURL=action-words.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"action-words.js","sourceRoot":"","sources":["../../src/tools/action-words.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import { Tool, CallToolRequest, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
+ import { CucumberStudioApiClient } from '../api/client.js';
3
+ export declare class ProjectTools {
4
+ private apiClient;
5
+ constructor(apiClient: CucumberStudioApiClient);
6
+ /**
7
+ * Get all available MCP tools for projects
8
+ */
9
+ getTools(): Tool[];
10
+ /**
11
+ * Handle tool calls for project-related operations
12
+ */
13
+ handleToolCall(request: CallToolRequest): Promise<CallToolResult>;
14
+ listProjects(args?: unknown): Promise<CallToolResult>;
15
+ getProject(args: {
16
+ projectId: string;
17
+ }): Promise<CallToolResult>;
18
+ }
19
+ //# sourceMappingURL=projects.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAAe,MAAM,oCAAoC,CAAA;AAEvG,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAK1D,qBAAa,YAAY;IACX,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,uBAAuB;IAEtD;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;IA0ClB;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAajE,YAAY,CAAC,IAAI,GAAE,OAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAsCzD,UAAU,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;CAkCvE"}
@@ -0,0 +1,123 @@
1
+ import { safeExecute } from '../utils/errors.js';
2
+ import { validateInput, ProjectIdSchema, ListParamsSchema, convertToApiParams } from '../utils/validation.js';
3
+ export class ProjectTools {
4
+ apiClient;
5
+ constructor(apiClient) {
6
+ this.apiClient = apiClient;
7
+ }
8
+ /**
9
+ * Get all available MCP tools for projects
10
+ */
11
+ getTools() {
12
+ return [
13
+ {
14
+ name: 'cucumberstudio_list_projects',
15
+ description: 'List all projects accessible to the authenticated user',
16
+ inputSchema: {
17
+ type: 'object',
18
+ properties: {
19
+ pagination: {
20
+ type: 'object',
21
+ properties: {
22
+ page: { type: 'number', minimum: 1, description: 'Page number' },
23
+ pageSize: { type: 'number', minimum: 1, maximum: 100, description: 'Number of items per page' },
24
+ },
25
+ additionalProperties: false,
26
+ },
27
+ filter: {
28
+ type: 'object',
29
+ properties: {
30
+ name: { type: 'string', description: 'Filter projects by name' },
31
+ },
32
+ additionalProperties: false,
33
+ },
34
+ },
35
+ additionalProperties: false,
36
+ },
37
+ },
38
+ {
39
+ name: 'cucumberstudio_get_project',
40
+ description: 'Get detailed information about a specific project',
41
+ inputSchema: {
42
+ type: 'object',
43
+ properties: {
44
+ projectId: { type: 'string', description: 'The ID of the project to retrieve' },
45
+ },
46
+ required: ['projectId'],
47
+ additionalProperties: false,
48
+ },
49
+ },
50
+ ];
51
+ }
52
+ /**
53
+ * Handle tool calls for project-related operations
54
+ */
55
+ async handleToolCall(request) {
56
+ switch (request.params.name) {
57
+ case 'cucumberstudio_list_projects':
58
+ return this.listProjects(request.params.arguments);
59
+ case 'cucumberstudio_get_project':
60
+ return this.getProject(request.params.arguments);
61
+ default:
62
+ throw new Error(`Unknown tool: ${request.params.name}`);
63
+ }
64
+ }
65
+ async listProjects(args = {}) {
66
+ return safeExecute(async () => {
67
+ const params = validateInput(ListParamsSchema, args, 'list_projects');
68
+ const apiParams = convertToApiParams(params);
69
+ const response = await this.apiClient.getProjects(apiParams);
70
+ const projects = Array.isArray(response.data) ? response.data : [response.data];
71
+ const projectList = projects.map((project) => {
72
+ const attrs = project.attributes;
73
+ return {
74
+ id: project.id,
75
+ name: attrs.name || 'Unknown',
76
+ description: attrs.description || '',
77
+ created_at: attrs.created_at,
78
+ updated_at: attrs.updated_at,
79
+ };
80
+ });
81
+ return {
82
+ content: [
83
+ {
84
+ type: 'text',
85
+ text: JSON.stringify({
86
+ projects: projectList,
87
+ meta: response.meta || {},
88
+ total_count: projectList.length,
89
+ }, null, 2),
90
+ },
91
+ ],
92
+ };
93
+ }, 'listing projects');
94
+ }
95
+ async getProject(args) {
96
+ return safeExecute(async () => {
97
+ const projectId = validateInput(ProjectIdSchema, args.projectId, 'get_project');
98
+ const response = await this.apiClient.getProject(projectId);
99
+ const project = response.data;
100
+ const projectDetails = {
101
+ id: project.id,
102
+ type: project.type,
103
+ name: project.attributes.name,
104
+ description: project.attributes.description || '',
105
+ created_at: project.attributes.created_at,
106
+ updated_at: project.attributes.updated_at,
107
+ relationships: project.relationships || {},
108
+ };
109
+ return {
110
+ content: [
111
+ {
112
+ type: 'text',
113
+ text: JSON.stringify({
114
+ project: projectDetails,
115
+ included: response.included || [],
116
+ }, null, 2),
117
+ },
118
+ ],
119
+ };
120
+ }, 'getting project details');
121
+ }
122
+ }
123
+ //# sourceMappingURL=projects.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"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"}