@qase/mcp-server 1.0.0-beta.1

package/build/utils/validation.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Validation Utilities
+ *
+ * Provides reusable Zod schemas and validation helpers for:
+ * - Common parameters (pagination, search, etc.)
+ * - Qase-specific formats (project codes, IDs, etc.)
+ * - Schema composition utilities
+ */
+import { z } from 'zod';
+/**
+ * Schema for pagination parameters
+ * Used across all list operations
+ */
+export declare const PaginationSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+/**
+ * Schema for Qase project codes
+ * Format: 2-10 uppercase letters, numbers, or underscores
+ * Examples: DEMO, TEST, MY_PROJECT, PROJECT_123
+ */
+export declare const ProjectCodeSchema: z.ZodString;
+/**
+ * Schema for search query strings
+ */
+export declare const SearchSchema: z.ZodOptional<z.ZodString>;
+/**
+ * Schema for entity IDs (positive integers)
+ */
+export declare const IdSchema: z.ZodNumber;
+/**
+ * Schema for hash identifiers (used by some entities like shared steps)
+ */
+export declare const HashSchema: z.ZodString;
+/**
+ * Schema for filtering by entity status
+ */
+export declare const StatusFilterSchema: z.ZodOptional<z.ZodEnum<["active", "archived", "deleted"]>>;
+/**
+ * Helper function to merge a schema with pagination parameters
+ *
+ * @param schema - The base schema to extend
+ * @returns Combined schema with pagination
+ *
+ * @example
+ * ```typescript
+ * const ListProjectsSchema = withPagination({
+ *   search: SearchSchema,
+ * });
+ * ```
+ */
+export declare function withPagination<T extends z.ZodRawShape>(schema: T): z.ZodObject<z.objectUtil.extendShape<T, {
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}>, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<z.objectUtil.extendShape<T, {
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}>>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<z.objectUtil.extendShape<T, {
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}>> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
+/**
+ * Helper function to add project code to a schema
+ *
+ * @param schema - The base schema to extend
+ * @returns Combined schema with project code
+ *
+ * @example
+ * ```typescript
+ * const GetCaseSchema = withProjectCode({
+ *   id: IdSchema,
+ * });
+ * // Results in: { code: ProjectCodeSchema, id: IdSchema }
+ * ```
+ */
+export declare function withProjectCode<T extends z.ZodRawShape>(schema: T): z.ZodObject<{
+    code: z.ZodString;
+} & T, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{
+    code: z.ZodString;
+} & T>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<{
+    code: z.ZodString;
+} & T> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;
+/**
+ * Helper function to make all fields in a schema optional
+ *
+ * @param schema - The schema to make partial
+ * @returns Schema with all fields optional
+ */
+export declare function makePartial<T extends z.ZodObject<z.ZodRawShape>>(schema: T): z.ZodObject<{
+    [x: string]: z.ZodOptional<z.ZodTypeAny>;
+}, z.UnknownKeysParam, z.ZodTypeAny, {
+    [x: string]: any;
+}, {
+    [x: string]: any;
+}>;
+export type Pagination = z.infer<typeof PaginationSchema>;
+export type ProjectCode = z.infer<typeof ProjectCodeSchema>;
+export type EntityId = z.infer<typeof IdSchema>;
+export type Hash = z.infer<typeof HashSchema>;
+//# sourceMappingURL=validation.d.ts.map

package/build/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAc3B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAQ+C,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,YAAY,4BAAwE,CAAC;AAElG;;GAEG;AACH,eAAO,MAAM,QAAQ,aAAuE,CAAC;AAE7F;;GAEG;AACH,eAAO,MAAM,UAAU,aAAyD,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,kBAAkB,6DAGO,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;;;;;;;;;mEAEhE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;;;;;;sEAKjE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;;;;;;GAE1E;AAGD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAChD,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/build/utils/validation.js

@@ -0,0 +1,104 @@
+/**
+ * Validation Utilities
+ *
+ * Provides reusable Zod schemas and validation helpers for:
+ * - Common parameters (pagination, search, etc.)
+ * - Qase-specific formats (project codes, IDs, etc.)
+ * - Schema composition utilities
+ */
+import { z } from 'zod';
+/**
+ * Schema for pagination parameters
+ * Used across all list operations
+ */
+export const PaginationSchema = z.object({
+    limit: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe('Maximum number of items to return (default: 10, max: 100)'),
+    offset: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe('Number of items to skip for pagination (default: 0)'),
+});
+/**
+ * Schema for Qase project codes
+ * Format: 2-10 uppercase letters, numbers, or underscores
+ * Examples: DEMO, TEST, MY_PROJECT, PROJECT_123
+ */
+export const ProjectCodeSchema = z
+    .string()
+    .min(2, 'Project code must be at least 2 characters')
+    .max(10, 'Project code must be at most 10 characters')
+    .regex(/^[A-Z0-9_]+$/, 'Project code must contain only uppercase letters, numbers, or underscores')
+    .describe('Project code (2-10 uppercase letters, numbers, or underscores)');
+/**
+ * Schema for search query strings
+ */
+export const SearchSchema = z.string().min(1).max(255).optional().describe('Search query string');
+/**
+ * Schema for entity IDs (positive integers)
+ */
+export const IdSchema = z.number().int().positive().describe('Entity ID (positive integer)');
+/**
+ * Schema for hash identifiers (used by some entities like shared steps)
+ */
+export const HashSchema = z.string().min(1).max(255).describe('Hash identifier');
+/**
+ * Schema for filtering by entity status
+ */
+export const StatusFilterSchema = z
+    .enum(['active', 'archived', 'deleted'])
+    .optional()
+    .describe('Filter by entity status');
+/**
+ * Helper function to merge a schema with pagination parameters
+ *
+ * @param schema - The base schema to extend
+ * @returns Combined schema with pagination
+ *
+ * @example
+ * ```typescript
+ * const ListProjectsSchema = withPagination({
+ *   search: SearchSchema,
+ * });
+ * ```
+ */
+export function withPagination(schema) {
+    return z.object(schema).merge(PaginationSchema);
+}
+/**
+ * Helper function to add project code to a schema
+ *
+ * @param schema - The base schema to extend
+ * @returns Combined schema with project code
+ *
+ * @example
+ * ```typescript
+ * const GetCaseSchema = withProjectCode({
+ *   id: IdSchema,
+ * });
+ * // Results in: { code: ProjectCodeSchema, id: IdSchema }
+ * ```
+ */
+export function withProjectCode(schema) {
+    return z.object({
+        code: ProjectCodeSchema,
+        ...schema,
+    });
+}
+/**
+ * Helper function to make all fields in a schema optional
+ *
+ * @param schema - The schema to make partial
+ * @returns Schema with all fields optional
+ */
+export function makePartial(schema) {
+    return schema.partial();
+}
+//# sourceMappingURL=validation.js.map

package/build/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2DAA2D,CAAC;IACxE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,WAAW,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,EAAE,4CAA4C,CAAC;KACpD,GAAG,CAAC,EAAE,EAAE,4CAA4C,CAAC;KACrD,KAAK,CACJ,cAAc,EACd,2EAA2E,CAC5E;KACA,QAAQ,CAAC,gEAAgE,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAElG;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;AAE7F;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAEjF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;KACvC,QAAQ,EAAE;KACV,QAAQ,CAAC,yBAAyB,CAAC,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAA0B,MAAS;IAC/D,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAA0B,MAAS;IAChE,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,iBAAiB;QACvB,GAAG,MAAM;KACV,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAuC,MAAS;IACzE,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@qase/mcp-server",
+  "version": "1.0.0-beta.1",
+  "description": "Official MCP server for Qase Test Management Platform",
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "qase-mcp-server": "build/index.js"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/qase-tms/qase-mcp-server.git"
+  },
+  "keywords": [
+    "mcp",
+    "qase",
+    "testing",
+    "test-management",
+    "model-context-protocol",
+    "test-automation",
+    "qa",
+    "quality-assurance",
+    "test-cases",
+    "test-runs",
+    "defect-tracking",
+    "claude",
+    "ai-assistant",
+    "llm",
+    "anthropic"
+  ],
+  "author": {
+    "name": "Qase",
+    "email": "support@qase.io",
+    "url": "https://qase.io"
+  },
+  "homepage": "https://github.com/qase-tms/qase-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/qase-tms/qase-mcp-server/issues",
+    "email": "support@qase.io"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x build/index.js",
+    "prepare": "husky",
+    "watch": "tsc --watch",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "inspector": "npx @modelcontextprotocol/inspector node build/index.js"
+  },
+  "lint-staged": {
+    "src/**/*.ts": [
+      "eslint --fix"
+    ]
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.6.0",
+    "axios": "^1.7.0",
+    "neverthrow": "^8.2.0",
+    "qaseio": "^2.4.1",
+    "zod": "^3.24.2",
+    "zod-to-json-schema": "^3.24.3"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.24",
+    "@typescript-eslint/eslint-plugin": "^8.26.1",
+    "@typescript-eslint/parser": "^8.26.1",
+    "eslint": "^9.22.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-prettier": "^5.2.3",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "lint-staged": "^16.2.3",
+    "prettier": "^3.4.2",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  }
+}