@testomatio/mcp 2.0.0 → 2.0.1-beta.1

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 (24) hide show
  1. package/README.md +76 -13
  2. package/package.json +3 -2
  3. package/src/api/http-client.js +12 -3
  4. package/src/api/testomatio-client.js +89 -8
  5. package/src/index.js +23 -2
  6. package/src/mcp/configs/entity-crud-config.js +12 -4
  7. package/src/mcp/definitions/labels.js +0 -25
  8. package/src/mcp/definitions/milestones.js +43 -0
  9. package/src/mcp/definitions/plans.js +38 -2
  10. package/src/mcp/definitions/requirements.js +163 -0
  11. package/src/mcp/definitions/rungroups.js +0 -25
  12. package/src/mcp/definitions/runs.js +18 -18
  13. package/src/mcp/definitions/snippets.js +2 -25
  14. package/src/mcp/definitions/steps.js +2 -25
  15. package/src/mcp/definitions/suites.js +6 -8
  16. package/src/mcp/definitions/testruns.js +194 -2
  17. package/src/mcp/definitions/tests.js +12 -36
  18. package/src/mcp/definitions/tql-reference.js +133 -0
  19. package/src/mcp/registry/handlers.js +17 -2
  20. package/src/mcp/registry/listings.js +101 -43
  21. package/src/mcp/registry/payloads.js +89 -8
  22. package/src/mcp/server.js +47 -4
  23. package/src/mcp/tool-definitions.js +4 -0
  24. package/src/mcp/tool-registry.js +7 -2
package/src/mcp/definitions/requirements.js ADDED
@@ -0,0 +1,163 @@
1
+ export const REQUIREMENTS_TOOLS = [
2
+ {
3
+ name: 'requirements_list',
4
+ description: 'List requirements (/api/v2/{project_id}/requirements)',
5
+ inputSchema: {
6
+ type: 'object',
7
+ properties: {
8
+ page: {
9
+ type: 'integer',
10
+ minimum: 1,
11
+ },
12
+ per_page: {
13
+ type: 'integer',
14
+ minimum: 1,
15
+ maximum: 100,
16
+ },
17
+ source: {
18
+ type: 'string',
19
+ enum: ['jira', 'confluence', 'file', 'text'],
20
+ },
21
+ scope: {
22
+ type: 'string',
23
+ enum: ['global', 'attached', 'detached', 'without_suites'],
24
+ },
25
+ },
26
+ additionalProperties: false,
27
+ },
28
+ },
29
+ {
30
+ name: 'requirements_get',
31
+ description: 'Get requirement by ID',
32
+ inputSchema: {
33
+ type: 'object',
34
+ properties: {
35
+ requirement_id: {
36
+ type: 'string',
37
+ },
38
+ },
39
+ required: ['requirement_id'],
40
+ additionalProperties: false,
41
+ },
42
+ },
43
+ {
44
+ name: 'requirements_create',
45
+ description: 'Create requirement (/api/v2/{project_id}/requirements)',
46
+ inputSchema: {
47
+ type: 'object',
48
+ properties: {
49
+ title: {
50
+ type: 'string',
51
+ },
52
+ source_type: {
53
+ type: 'string',
54
+ enum: ['jira', 'confluence', 'file', 'text'],
55
+ },
56
+ description: {
57
+ type: 'string',
58
+ description: 'Required for text requirements. Must be at least 500 characters.',
59
+ },
60
+ details: {
61
+ type: 'string',
62
+ },
63
+ active: {
64
+ type: 'boolean',
65
+ },
66
+ global: {
67
+ type: 'boolean',
68
+ },
69
+ confluence_url: {
70
+ type: 'string',
71
+ description: 'Required for confluence requirements.',
72
+ },
73
+ files: {
74
+ type: 'array',
75
+ items: {
76
+ type: 'string',
77
+ },
78
+ description: 'Local file paths to upload for file requirements.',
79
+ },
80
+ },
81
+ required: ['title', 'source_type'],
82
+ additionalProperties: false,
83
+ },
84
+ },
85
+ {
86
+ name: 'requirements_update',
87
+ description: 'Update requirement (/api/v2/{project_id}/requirements/{id})',
88
+ inputSchema: {
89
+ type: 'object',
90
+ properties: {
91
+ requirement_id: {
92
+ type: 'string',
93
+ },
94
+ title: {
95
+ type: 'string',
96
+ },
97
+ description: {
98
+ type: 'string',
99
+ description: 'Only applied for text requirements.',
100
+ },
101
+ details: {
102
+ type: 'string',
103
+ },
104
+ active: {
105
+ type: 'boolean',
106
+ },
107
+ global: {
108
+ type: 'boolean',
109
+ },
110
+ files: {
111
+ type: 'array',
112
+ items: {
113
+ type: 'string',
114
+ },
115
+ description: 'Local file paths to upload for file requirements.',
116
+ },
117
+ },
118
+ required: ['requirement_id'],
119
+ additionalProperties: false,
120
+ },
121
+ },
122
+ {
123
+ name: 'requirements_delete',
124
+ description: 'Delete requirement (/api/v2/{project_id}/requirements/{id})',
125
+ inputSchema: {
126
+ type: 'object',
127
+ properties: {
128
+ requirement_id: {
129
+ type: 'string',
130
+ },
131
+ },
132
+ required: ['requirement_id'],
133
+ additionalProperties: false,
134
+ },
135
+ },
136
+ {
137
+ name: 'requirements_search',
138
+ description: 'Search requirements (delegates to requirements list with filters)',
139
+ inputSchema: {
140
+ type: 'object',
141
+ properties: {
142
+ page: {
143
+ type: 'integer',
144
+ minimum: 1,
145
+ },
146
+ per_page: {
147
+ type: 'integer',
148
+ minimum: 1,
149
+ maximum: 100,
150
+ },
151
+ source: {
152
+ type: 'string',
153
+ enum: ['jira', 'confluence', 'file', 'text'],
154
+ },
155
+ scope: {
156
+ type: 'string',
157
+ enum: ['global', 'attached', 'detached', 'without_suites'],
158
+ },
159
+ },
160
+ additionalProperties: false,
161
+ },
162
+ },
163
+ ];
package/src/mcp/definitions/rungroups.js CHANGED
@@ -13,9 +13,6 @@ export const RUNGROUPS_TOOLS = [
13
13
  "type": "integer",
14
14
  "minimum": 1,
15
15
  "maximum": 100
16
- },
17
- "query": {
18
- "type": "string"
19
16
  }
20
17
  },
21
18
  "additionalProperties": false
@@ -130,26 +127,4 @@ export const RUNGROUPS_TOOLS = [
130
127
  "additionalProperties": false
131
128
  }
132
129
  },
133
- {
134
- "name": "rungroups_search",
135
- "description": "Search run groups (delegates to rungroups list; docs has no dedicated search parameter)",
136
- "inputSchema": {
137
- "type": "object",
138
- "properties": {
139
- "query": {
140
- "type": "string"
141
- },
142
- "page": {
143
- "type": "integer",
144
- "minimum": 1
145
- },
146
- "per_page": {
147
- "type": "integer",
148
- "minimum": 1,
149
- "maximum": 100
150
- }
151
- },
152
- "additionalProperties": false
153
- }
154
- }
155
130
  ];
package/src/mcp/definitions/runs.js CHANGED
@@ -1,7 +1,9 @@
1
+ import { RUNS_TQL_INPUT_DESCRIPTION, RUNS_TQL_REFERENCE } from './tql-reference.js';
2
+
1
3
  export const RUNS_TOOLS = [
2
4
  {
3
5
  "name": "runs_list",
4
- "description": "List runs (/api/v2/{project_id}/runs)",
6
+ "description": `List runs (/api/v2/{project_id}/runs). ${RUNS_TQL_REFERENCE}`,
5
7
  "inputSchema": {
6
8
  "type": "object",
7
9
  "properties": {
@@ -14,8 +16,9 @@ export const RUNS_TOOLS = [
14
16
  "minimum": 1,
15
17
  "maximum": 100
16
18
  },
17
- "query": {
18
- "type": "string"
19
+ "tql": {
20
+ "type": "string",
21
+ "description": RUNS_TQL_INPUT_DESCRIPTION
19
22
  }
20
23
  },
21
24
  "additionalProperties": false
@@ -49,8 +52,11 @@ export const RUNS_TOOLS = [
49
52
  "description": {
50
53
  "type": "string"
51
54
  },
52
- "plan_id": {
53
- "type": "string"
55
+ "plan_ids": {
56
+ "type": "array",
57
+ "items": {
58
+ "type": "string"
59
+ }
54
60
  },
55
61
  "kind": {
56
62
  "type": "string",
@@ -95,9 +101,6 @@ export const RUNS_TOOLS = [
95
101
  "type": "string"
96
102
  }
97
103
  },
98
- "configuration": {
99
- "type": "object"
100
- },
101
104
  "link": {
102
105
  "type": "array",
103
106
  "items": {
@@ -116,6 +119,7 @@ export const RUNS_TOOLS = [
116
119
  "label",
117
120
  "custom_field",
118
121
  "tag",
122
+ "milestone",
119
123
  "issue",
120
124
  "jira"
121
125
  ]
@@ -154,9 +158,6 @@ export const RUNS_TOOLS = [
154
158
  "description": {
155
159
  "type": "string"
156
160
  },
157
- "plan_id": {
158
- "type": "string"
159
- },
160
161
  "kind": {
161
162
  "type": "string",
162
163
  "enum": [
@@ -205,9 +206,6 @@ export const RUNS_TOOLS = [
205
206
  "type": "string"
206
207
  }
207
208
  },
208
- "configuration": {
209
- "type": "object"
210
- },
211
209
  "link": {
212
210
  "type": "array",
213
211
  "items": {
@@ -226,6 +224,7 @@ export const RUNS_TOOLS = [
226
224
  "label",
227
225
  "custom_field",
228
226
  "tag",
227
+ "milestone",
229
228
  "issue",
230
229
  "jira"
231
230
  ]
@@ -267,13 +266,10 @@ export const RUNS_TOOLS = [
267
266
  },
268
267
  {
269
268
  "name": "runs_search",
270
- "description": "Search runs (delegates to runs list; docs has no dedicated search parameter)",
269
+ "description": `Search runs using TQL (delegates to runs_list). ${RUNS_TQL_REFERENCE}`,
271
270
  "inputSchema": {
272
271
  "type": "object",
273
272
  "properties": {
274
- "query": {
275
- "type": "string"
276
- },
277
273
  "page": {
278
274
  "type": "integer",
279
275
  "minimum": 1
@@ -282,6 +278,10 @@ export const RUNS_TOOLS = [
282
278
  "type": "integer",
283
279
  "minimum": 1,
284
280
  "maximum": 100
281
+ },
282
+ "tql": {
283
+ "type": "string",
284
+ "description": RUNS_TQL_INPUT_DESCRIPTION
285
285
  }
286
286
  },
287
287
  "additionalProperties": false
package/src/mcp/definitions/snippets.js CHANGED
@@ -13,9 +13,6 @@ export const SNIPPETS_TOOLS = [
13
13
  "type": "integer",
14
14
  "minimum": 1,
15
15
  "maximum": 100
16
- },
17
- "query": {
18
- "type": "string"
19
16
  }
20
17
  },
21
18
  "additionalProperties": false
@@ -67,6 +64,7 @@ export const SNIPPETS_TOOLS = [
67
64
  "label",
68
65
  "custom_field",
69
66
  "tag",
67
+ "milestone",
70
68
  "issue",
71
69
  "jira"
72
70
  ]
@@ -123,6 +121,7 @@ export const SNIPPETS_TOOLS = [
123
121
  "label",
124
122
  "custom_field",
125
123
  "tag",
124
+ "milestone",
126
125
  "issue",
127
126
  "jira"
128
127
  ]
@@ -162,26 +161,4 @@ export const SNIPPETS_TOOLS = [
162
161
  "additionalProperties": false
163
162
  }
164
163
  },
165
- {
166
- "name": "snippets_search",
167
- "description": "Search snippets (delegates to snippets list; docs has no dedicated search parameter)",
168
- "inputSchema": {
169
- "type": "object",
170
- "properties": {
171
- "query": {
172
- "type": "string"
173
- },
174
- "page": {
175
- "type": "integer",
176
- "minimum": 1
177
- },
178
- "per_page": {
179
- "type": "integer",
180
- "minimum": 1,
181
- "maximum": 100
182
- }
183
- },
184
- "additionalProperties": false
185
- }
186
- }
187
164
  ];
package/src/mcp/definitions/steps.js CHANGED
@@ -13,9 +13,6 @@ export const STEPS_TOOLS = [
13
13
  "type": "integer",
14
14
  "minimum": 1,
15
15
  "maximum": 100
16
- },
17
- "query": {
18
- "type": "string"
19
16
  }
20
17
  },
21
18
  "additionalProperties": false
@@ -67,6 +64,7 @@ export const STEPS_TOOLS = [
67
64
  "label",
68
65
  "custom_field",
69
66
  "tag",
67
+ "milestone",
70
68
  "issue",
71
69
  "jira"
72
70
  ]
@@ -123,6 +121,7 @@ export const STEPS_TOOLS = [
123
121
  "label",
124
122
  "custom_field",
125
123
  "tag",
124
+ "milestone",
126
125
  "issue",
127
126
  "jira"
128
127
  ]
@@ -162,26 +161,4 @@ export const STEPS_TOOLS = [
162
161
  "additionalProperties": false
163
162
  }
164
163
  },
165
- {
166
- "name": "steps_search",
167
- "description": "Search steps (delegates to steps list; docs has no dedicated search parameter)",
168
- "inputSchema": {
169
- "type": "object",
170
- "properties": {
171
- "query": {
172
- "type": "string"
173
- },
174
- "page": {
175
- "type": "integer",
176
- "minimum": 1
177
- },
178
- "per_page": {
179
- "type": "integer",
180
- "minimum": 1,
181
- "maximum": 100
182
- }
183
- },
184
- "additionalProperties": false
185
- }
186
- }
187
164
  ];
package/src/mcp/definitions/suites.js CHANGED
@@ -29,9 +29,6 @@ export const SUITES_TOOLS = [
29
29
  },
30
30
  "search_text": {
31
31
  "type": "string"
32
- },
33
- "query": {
34
- "type": "string"
35
32
  }
36
33
  },
37
34
  "additionalProperties": false
@@ -101,8 +98,10 @@ export const SUITES_TOOLS = [
101
98
  "label",
102
99
  "custom_field",
103
100
  "tag",
101
+ "milestone",
104
102
  "issue",
105
- "jira"
103
+ "jira",
104
+ "requirement"
106
105
  ]
107
106
  },
108
107
  "value": {
@@ -175,8 +174,10 @@ export const SUITES_TOOLS = [
175
174
  "label",
176
175
  "custom_field",
177
176
  "tag",
177
+ "milestone",
178
178
  "issue",
179
- "jira"
179
+ "jira",
180
+ "requirement"
180
181
  ]
181
182
  },
182
183
  "value": {
@@ -223,9 +224,6 @@ export const SUITES_TOOLS = [
223
224
  "search_text": {
224
225
  "type": "string"
225
226
  },
226
- "query": {
227
- "type": "string"
228
- },
229
227
  "page": {
230
228
  "type": "integer",
231
229
  "minimum": 1
package/src/mcp/definitions/testruns.js CHANGED
@@ -17,8 +17,104 @@ export const TESTRUNS_TOOLS = [
17
17
  "run_id": {
18
18
  "type": "string"
19
19
  },
20
- "query": {
20
+ "test_ids": {
21
+ "type": [
22
+ "array",
23
+ "string"
24
+ ],
25
+ "items": {
26
+ "type": "string"
27
+ }
28
+ },
29
+ "filter_status": {
30
+ "type": "string",
31
+ "enum": [
32
+ "passed",
33
+ "failed",
34
+ "skipped",
35
+ "pending"
36
+ ]
37
+ },
38
+ "filter_kind": {
39
+ "type": "string",
40
+ "enum": [
41
+ "manual",
42
+ "automated"
43
+ ]
44
+ },
45
+ "filter_user": {
46
+ "type": [
47
+ "integer",
48
+ "string"
49
+ ]
50
+ },
51
+ "filter_priority": {
52
+ "type": "string",
53
+ "enum": [
54
+ "low",
55
+ "normal",
56
+ "important",
57
+ "high",
58
+ "critical"
59
+ ]
60
+ },
61
+ "filter_substatus": {
21
62
  "type": "string"
63
+ },
64
+ "filter_search": {
65
+ "type": "string"
66
+ },
67
+ "filter_message": {
68
+ "type": "boolean"
69
+ },
70
+ "filter_link": {
71
+ "type": "boolean"
72
+ },
73
+ "filter_finished_at_date_range": {
74
+ "type": "string"
75
+ },
76
+ "tags": {
77
+ "type": [
78
+ "array",
79
+ "string"
80
+ ],
81
+ "items": {
82
+ "type": "string"
83
+ }
84
+ },
85
+ "labels": {
86
+ "type": [
87
+ "array",
88
+ "string"
89
+ ],
90
+ "items": {
91
+ "type": "string"
92
+ }
93
+ },
94
+ "envs": {
95
+ "type": [
96
+ "array",
97
+ "string"
98
+ ],
99
+ "items": {
100
+ "type": "string"
101
+ }
102
+ },
103
+ "rungroups": {
104
+ "type": [
105
+ "array",
106
+ "string"
107
+ ],
108
+ "items": {
109
+ "type": "string"
110
+ }
111
+ },
112
+ "defects": {
113
+ "type": "string",
114
+ "enum": [
115
+ "has_defects",
116
+ "without_defects"
117
+ ]
22
118
  }
23
119
  },
24
120
  "additionalProperties": false
@@ -142,7 +238,51 @@ export const TESTRUNS_TOOLS = [
142
238
  "run_id": {
143
239
  "type": "string"
144
240
  },
145
- "query": {
241
+ "test_ids": {
242
+ "type": [
243
+ "array",
244
+ "string"
245
+ ],
246
+ "items": {
247
+ "type": "string"
248
+ }
249
+ },
250
+ "filter_status": {
251
+ "type": "string",
252
+ "enum": [
253
+ "passed",
254
+ "failed",
255
+ "skipped",
256
+ "pending"
257
+ ]
258
+ },
259
+ "filter_kind": {
260
+ "type": "string",
261
+ "enum": [
262
+ "manual",
263
+ "automated"
264
+ ]
265
+ },
266
+ "filter_user": {
267
+ "type": [
268
+ "integer",
269
+ "string"
270
+ ]
271
+ },
272
+ "filter_priority": {
273
+ "type": "string",
274
+ "enum": [
275
+ "low",
276
+ "normal",
277
+ "important",
278
+ "high",
279
+ "critical"
280
+ ]
281
+ },
282
+ "filter_substatus": {
283
+ "type": "string"
284
+ },
285
+ "filter_search": {
146
286
  "type": "string"
147
287
  },
148
288
  "page": {
@@ -153,6 +293,58 @@ export const TESTRUNS_TOOLS = [
153
293
  "type": "integer",
154
294
  "minimum": 1,
155
295
  "maximum": 100
296
+ },
297
+ "filter_message": {
298
+ "type": "boolean"
299
+ },
300
+ "filter_link": {
301
+ "type": "boolean"
302
+ },
303
+ "filter_finished_at_date_range": {
304
+ "type": "string"
305
+ },
306
+ "tags": {
307
+ "type": [
308
+ "array",
309
+ "string"
310
+ ],
311
+ "items": {
312
+ "type": "string"
313
+ }
314
+ },
315
+ "labels": {
316
+ "type": [
317
+ "array",
318
+ "string"
319
+ ],
320
+ "items": {
321
+ "type": "string"
322
+ }
323
+ },
324
+ "envs": {
325
+ "type": [
326
+ "array",
327
+ "string"
328
+ ],
329
+ "items": {
330
+ "type": "string"
331
+ }
332
+ },
333
+ "rungroups": {
334
+ "type": [
335
+ "array",
336
+ "string"
337
+ ],
338
+ "items": {
339
+ "type": "string"
340
+ }
341
+ },
342
+ "defects": {
343
+ "type": "string",
344
+ "enum": [
345
+ "has_defects",
346
+ "without_defects"
347
+ ]
156
348
  }
157
349
  },
158
350
  "additionalProperties": false