cucumberstudio-mcp 1.1.0

package/build/utils/logger.js

@@ -0,0 +1,113 @@
+import { DEFAULT_LOG_LEVEL } from '../constants.js';
+import { LOG_COLORS as ANSI_COLORS } from './logger-constants.js';
+const LOG_LEVELS = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    debug: 3,
+    trace: 4,
+};
+const LOG_COLORS = {
+    error: ANSI_COLORS.ERROR,
+    warn: ANSI_COLORS.WARN,
+    info: ANSI_COLORS.INFO,
+    debug: ANSI_COLORS.DEBUG,
+    trace: ANSI_COLORS.DEBUG, // Using same as debug
+};
+const RESET_COLOR = ANSI_COLORS.RESET;
+/**
+ * No-operation logger for testing - discards all log messages
+ */
+export class NoOpLogger {
+    error() { }
+    warn() { }
+    info() { }
+    debug() { }
+    trace() { }
+}
+/**
+ * Logger implementation that outputs to stderr
+ * Safe for use with STDIO MCP transport as it won't interfere with stdout protocol
+ */
+export class StderrLogger {
+    config;
+    constructor(config) {
+        this.config = {
+            enableTimestamp: true,
+            enableColors: true,
+            ...config,
+        };
+    }
+    shouldLog(level) {
+        return LOG_LEVELS[level] <= LOG_LEVELS[this.config.level];
+    }
+    formatMessage(level, message, meta) {
+        let formatted = '';
+        // Add timestamp if enabled
+        if (this.config.enableTimestamp) {
+            formatted += `[${new Date().toISOString()}] `;
+        }
+        // Add level with color if enabled
+        const levelUpper = level.toUpperCase().padEnd(5);
+        if (this.config.enableColors) {
+            formatted += `${LOG_COLORS[level]}${levelUpper}${RESET_COLOR} `;
+        }
+        else {
+            formatted += `${levelUpper} `;
+        }
+        // Add prefix if configured
+        if (this.config.prefix) {
+            formatted += `${this.config.prefix} `;
+        }
+        // Add message
+        formatted += message;
+        // Add metadata
+        if (meta !== undefined) {
+            if (typeof meta === 'object') {
+                formatted += ` ${JSON.stringify(meta)}`;
+            }
+            else {
+                formatted += ` ${String(meta)}`;
+            }
+        }
+        return formatted;
+    }
+    writeLog(level, message, meta) {
+        if (!this.shouldLog(level))
+            return;
+        const formatted = this.formatMessage(level, message, meta);
+        console.error(formatted);
+    }
+    error(message, meta) {
+        this.writeLog('error', message, meta);
+    }
+    warn(message, meta) {
+        this.writeLog('warn', message, meta);
+    }
+    info(message, meta) {
+        this.writeLog('info', message, meta);
+    }
+    debug(message, meta) {
+        this.writeLog('debug', message, meta);
+    }
+    trace(message, meta) {
+        this.writeLog('trace', message, meta);
+    }
+}
+/**
+ * No-op logger for testing or when logging is disabled
+ */
+export class NoopLogger {
+    error() { }
+    warn() { }
+    info() { }
+    debug() { }
+    trace() { }
+}
+/**
+ * Helper to get log level from environment
+ */
+export function getLogLevel() {
+    return process.env.LOG_LEVEL || DEFAULT_LOG_LEVEL;
+}
+//# sourceMappingURL=logger.js.map

package/build/utils/logger.js.map

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

package/build/utils/validation.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+export declare const ProjectIdSchema: z.ZodString;
+export declare const ScenarioIdSchema: z.ZodString;
+export declare const ActionWordIdSchema: z.ZodString;
+export declare const FolderIdSchema: z.ZodString;
+export declare const TestRunIdSchema: z.ZodString;
+export declare const BuildIdSchema: z.ZodString;
+export declare const PaginationSchema: z.ZodOptional<z.ZodObject<{
+    page: z.ZodOptional<z.ZodNumber>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page?: number | undefined;
+    pageSize?: number | undefined;
+}, {
+    page?: number | undefined;
+    pageSize?: number | undefined;
+}>>;
+export declare const FilterSchema: z.ZodOptional<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    tags?: string | undefined;
+}, {
+    name?: string | undefined;
+    tags?: string | undefined;
+}>>;
+export declare const ListParamsSchema: z.ZodOptional<z.ZodObject<{
+    pagination: z.ZodOptional<z.ZodObject<{
+        page: z.ZodOptional<z.ZodNumber>;
+        pageSize: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        page?: number | undefined;
+        pageSize?: number | undefined;
+    }, {
+        page?: number | undefined;
+        pageSize?: number | undefined;
+    }>>;
+    filter: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        tags?: string | undefined;
+    }, {
+        name?: string | undefined;
+        tags?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    filter?: {
+        name?: string | undefined;
+        tags?: string | undefined;
+    } | undefined;
+    pagination?: {
+        page?: number | undefined;
+        pageSize?: number | undefined;
+    } | undefined;
+}, {
+    filter?: {
+        name?: string | undefined;
+        tags?: string | undefined;
+    } | undefined;
+    pagination?: {
+        page?: number | undefined;
+        pageSize?: number | undefined;
+    } | undefined;
+}>>;
+/**
+ * Convert pagination and filter parameters to API format
+ */
+export declare function convertToApiParams(params?: {
+    pagination?: {
+        page?: number;
+        pageSize?: number;
+    };
+    filter?: {
+        name?: string;
+        tags?: string;
+    };
+}): Record<string, unknown>;
+/**
+ * Validate input against a schema and throw MCP error if invalid
+ */
+export declare function validateInput<T>(schema: z.ZodSchema<T>, input: unknown, context?: string): T;
+/**
+ * Validate that required environment variables are present
+ */
+export declare function validateEnvironment(): void;
+//# 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":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,eAAe,aAA8C,CAAA;AAC1E,eAAO,MAAM,gBAAgB,aAA+C,CAAA;AAC5E,eAAO,MAAM,kBAAkB,aAAkD,CAAA;AACjF,eAAO,MAAM,cAAc,aAA6C,CAAA;AACxE,eAAO,MAAM,eAAe,aAA+C,CAAA;AAC3E,eAAO,MAAM,aAAa,aAA4C,CAAA;AAGtE,eAAO,MAAM,gBAAgB;;;;;;;;;GAKhB,CAAA;AAGb,eAAO,MAAM,YAAY;;;;;;;;;GAKZ,CAAA;AAGb,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAKhB,CAAA;AAEb;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE;IAC1C,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACjD,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1C,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsB1B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAU5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAQ1C"}

package/build/utils/validation.js

@@ -0,0 +1,78 @@
+import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { MAX_PAGE_SIZE } from '../constants.js';
+// Common validation schemas
+export const ProjectIdSchema = z.string().min(1, 'Project ID is required');
+export const ScenarioIdSchema = z.string().min(1, 'Scenario ID is required');
+export const ActionWordIdSchema = z.string().min(1, 'Action Word ID is required');
+export const FolderIdSchema = z.string().min(1, 'Folder ID is required');
+export const TestRunIdSchema = z.string().min(1, 'Test Run ID is required');
+export const BuildIdSchema = z.string().min(1, 'Build ID is required');
+// Pagination schema
+export const PaginationSchema = z
+    .object({
+    page: z.number().int().min(1).optional(),
+    pageSize: z.number().int().min(1).max(MAX_PAGE_SIZE).optional(),
+})
+    .optional();
+// Filter schema
+export const FilterSchema = z
+    .object({
+    name: z.string().optional(),
+    tags: z.string().optional(),
+})
+    .optional();
+// List parameters schema
+export const ListParamsSchema = z
+    .object({
+    pagination: PaginationSchema,
+    filter: FilterSchema,
+})
+    .optional();
+/**
+ * Convert pagination and filter parameters to API format
+ */
+export function convertToApiParams(params) {
+    if (!params)
+        return {};
+    const apiParams = {};
+    if (params.pagination?.page) {
+        apiParams['page[number]'] = params.pagination.page;
+    }
+    if (params.pagination?.pageSize) {
+        apiParams['page[size]'] = params.pagination.pageSize;
+    }
+    if (params.filter?.name) {
+        apiParams['filter[name]'] = params.filter.name;
+    }
+    if (params.filter?.tags) {
+        apiParams['filter[tags]'] = params.filter.tags;
+    }
+    return apiParams;
+}
+/**
+ * Validate input against a schema and throw MCP error if invalid
+ */
+export function validateInput(schema, input, context) {
+    try {
+        return schema.parse(input);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const issues = error.errors.map((e) => `${e.path.join('.')}: ${e.message}`).join(', ');
+            throw new McpError(ErrorCode.InvalidParams, `Invalid parameters${context ? ` for ${context}` : ''}: ${issues}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Validate that required environment variables are present
+ */
+export function validateEnvironment() {
+    const required = ['CUCUMBERSTUDIO_ACCESS_TOKEN', 'CUCUMBERSTUDIO_CLIENT_ID', 'CUCUMBERSTUDIO_UID'];
+    const missing = required.filter((envVar) => !process.env[envVar]);
+    if (missing.length > 0) {
+        throw new McpError(ErrorCode.InvalidRequest, `Missing required environment variables: ${missing.join(', ')}`);
+    }
+}
+//# 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":"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"}

package/docker-compose.yml

@@ -0,0 +1,20 @@
+version: '3.8'
+
+services:
+  cucumberstudio-mcp:
+    build: .
+    env_file:
+      - .env
+    restart: unless-stopped
+    ports:
+      - "${MCP_PORT:-3000}:3000"
+    healthcheck:
+      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:3000/health", "||", "exit", "1"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+networks:
+  default:
+    name: cucumberstudio-mcp-network

package/eslint.config.js

@@ -0,0 +1,97 @@
+import tseslint from '@typescript-eslint/eslint-plugin'
+import tsparser from '@typescript-eslint/parser'
+import importPlugin from 'eslint-plugin-import'
+
+export default [
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: tsparser,
+      parserOptions: {
+        ecmaVersion: 2022,
+        sourceType: 'module',
+        project: './tsconfig.json',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint,
+      import: importPlugin,
+    },
+    settings: {
+      'import/resolver': {
+        typescript: {
+          alwaysTryTypes: true,
+          project: './tsconfig.json',
+        },
+      },
+    },
+    rules: {
+      // TypeScript-specific rules
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-non-null-assertion': 'off', // Allow ! in Result pattern
+
+      // Import organization rules
+      'import/order': [
+        'error',
+        {
+          groups: [
+            'builtin', // Node.js built-in modules
+            'external', // External libraries
+            'internal', // Internal modules (using path mapping)
+            'parent', // Parent directories
+            'sibling', // Same directory
+            'index', // Index files
+          ],
+          'newlines-between': 'always',
+          alphabetize: {
+            order: 'asc',
+            caseInsensitive: true,
+          },
+          pathGroups: [
+            {
+              pattern: '@/**',
+              group: 'internal',
+              position: 'before',
+            },
+          ],
+          pathGroupsExcludedImportTypes: ['builtin'],
+        },
+      ],
+      'import/newline-after-import': 'error',
+      'import/no-duplicates': 'error',
+      'import/no-unused-modules': 'off', // Can be enabled for stricter checking
+
+      // General code quality rules
+      'no-console': 'off', // Allow console for this MCP server
+      'no-debugger': 'error',
+      'no-unused-vars': 'off', // Use TypeScript version instead
+      'prefer-const': 'error',
+      'no-var': 'error',
+      'object-shorthand': 'error',
+      'prefer-arrow-callback': 'error',
+    },
+  },
+  {
+    files: ['**/*.test.ts', '**/*.spec.ts', 'test/**/*.ts'],
+    rules: {
+      // Relax some rules for test files
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-non-null-assertion': 'off',
+      '@typescript-eslint/no-unused-vars': 'off',
+    },
+  },
+  {
+    // Ignore patterns
+    ignores: [
+      'build/**',
+      'node_modules/**',
+      'coverage/**',
+      '*.js', // Ignore JS files in root (like this config file)
+      'vitest.config.ts', // Vitest config not in main tsconfig
+      '**/*.d.ts', // Ignore generated TypeScript declaration files
+    ],
+  },
+]

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "cucumberstudio-mcp",
+  "version": "1.1.0",
+  "description": "MCP server for Cucumber Studio API integration",
+  "main": "build/index.js",
+  "type": "module",
+  "bin": {
+    "cucumberstudio-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "prepare": "node scripts/generate-version.js",
+    "prebuild": "node scripts/generate-version.js",
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "start": "node build/index.js",
+    "start:http": "MCP_TRANSPORT=http node build/index.js",
+    "dev": "tsx --watch -r tsconfig-paths/register src/index.ts",
+    "dev:http": "MCP_TRANSPORT=http tsx --watch -r tsconfig-paths/register src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "test:ui-coverage": "vitest --ui --coverage",
+    "lint": "eslint src test --ext .ts",
+    "lint:fix": "eslint src test --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "docker:build": "docker build -t cucumberstudio-mcp .",
+    "docker:build:dev": "docker build -f Dockerfile.dev -t cucumberstudio-mcp:dev .",
+    "docker:run": "docker run --env-file .env cucumberstudio-mcp",
+    "docker:run:dev": "docker run --env-file .env -v $(pwd)/src:/app/src cucumberstudio-mcp:dev",
+    "docker:compose:up": "docker-compose up",
+    "docker:compose:up:dev": "docker-compose --profile dev up cucumberstudio-mcp-dev",
+    "docker:compose:down": "docker-compose down",
+    "docker:compose:build": "docker-compose build"
+  },
+  "keywords": [
+    "mcp",
+    "cucumber",
+    "testing",
+    "api",
+    "automation",
+    "model-context-protocol",
+    "cucumber-studio",
+    "ai",
+    "llm"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/HeroSizy/cucumberstudio-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/HeroSizy/cucumberstudio-mcp/issues"
+  },
+  "homepage": "https://github.com/HeroSizy/cucumberstudio-mcp#readme",
+  "preferGlobal": true,
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.3",
+    "axios": "^1.6.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.5.0",
+    "express": "^4.18.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.0",
+    "@types/express": "^4.17.0",
+    "@types/node": "^22.15.30",
+    "@typescript-eslint/eslint-plugin": "^8.34.0",
+    "@typescript-eslint/parser": "^8.34.0",
+    "@vitest/coverage-v8": "^3.2.2",
+    "@vitest/ui": "^3.2.2",
+    "eslint": "^9.28.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-import-resolver-typescript": "^4.4.3",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-prettier": "^5.0.0",
+    "msw": "^2.10.2",
+    "prettier": "^3.5.3",
+    "tsc-alias": "^1.8.16",
+    "tsconfig-paths": "^4.2.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.8.3",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.2.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/scripts/generate-version.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync, mkdirSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+
+// Get current directory for ES modules
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+// Read package.json
+const packagePath = join(__dirname, '..', 'package.json')
+const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'))
+
+// Generate version constants file
+const versionContent = `// Auto-generated version info - DO NOT EDIT
+// Generated at build time from package.json
+
+export const PACKAGE_VERSION = '${packageJson.version}'
+export const PACKAGE_NAME = '${packageJson.name}'
+`
+
+// Ensure the generated directory exists
+const generatedDir = join(__dirname, '..', 'src', 'generated')
+mkdirSync(generatedDir, { recursive: true })
+
+// Write to src/generated/version.ts
+const outputPath = join(generatedDir, 'version.ts')
+writeFileSync(outputPath, versionContent)
+
+console.log(`✅ Generated version constants: ${packageJson.name}@${packageJson.version}`)