@testomatio/mcp-enterprise 2.0.1

package/README.md

@@ -0,0 +1,22 @@
+# Testomat.io MCP Enterprise
+
+Enterprise Model Context Protocol server for Testomat.io API v2.
+
+This package includes all tools from `@testomatio/mcp` plus enterprise analytics tools:
+
+- `analytics_tests`
+- `analytics_stats`
+
+## Installation
+
+```bash
+npm install -g @testomatio/mcp-enterprise@latest
+```
+
+## Usage
+
+```bash
+testomatio-mcp-enterprise --token <PROJECT_TOKEN> --project <PROJECT_ID>
+```
+
+Analytics endpoints require the `api_analytics` subscription feature.

package/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { main } from './src/main.js';
+
+main(process.argv).catch((error) => {
+  console.error('Fatal startup error:', error.message || error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@testomatio/mcp-enterprise",
+  "version": "2.0.1",
+  "description": "Enterprise Model Context Protocol server for Testomat.io API with analytics tools",
+  "main": "index.js",
+  "bin": {
+    "testomatio-mcp-enterprise": "index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "prepack": "node ../../scripts/sync-enterprise-package.js"
+  },
+  "keywords": [
+    "testomatio",
+    "mcp",
+    "model-context-protocol",
+    "testing",
+    "api",
+    "analytics",
+    "enterprise"
+  ],
+  "author": "Testomatio Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/testomatio/mcp",
+    "directory": "packages/enterprise"
+  },
+  "dependencies": {
+    "@testomatio/mcp": "2.0.1",
+    "commander": "^12.0.0"
+  },
+  "files": [
+    "index.js",
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/analytics.js

@@ -0,0 +1,181 @@
+import {
+  ANALYTICS_STATS_TQL_INPUT_DESCRIPTION,
+  ANALYTICS_STATS_TQL_REFERENCE,
+  ANALYTICS_TESTS_TQL_INPUT_DESCRIPTION,
+  ANALYTICS_TESTS_TQL_REFERENCE,
+  TOOL_DEFINITIONS,
+} from './load-core.js';
+
+const ANALYTICS_TEST_KINDS = [
+  'flaky',
+  'slow',
+  'failing',
+  'evergreen',
+  'never-executed',
+  'skipped',
+  'failures',
+  'defects',
+  'issues',
+];
+
+const ANALYTICS_STATS_KINDS = [
+  'project-summary',
+  'runs-summary',
+  'success-rate-by-date',
+  'automation-rate-by-date',
+  'testruns-by-date',
+  'priority-by-date',
+];
+
+const commonAnalyticsProperties = {
+  days: {
+    type: 'integer',
+    minimum: 1,
+    description: 'Lookback window in days. Ignored when from/to are provided.',
+  },
+  from: {
+    type: 'string',
+    description: 'Inclusive start date in YYYY-MM-DD format. Takes precedence over days.',
+  },
+  to: {
+    type: 'string',
+    description: 'Inclusive end date in YYYY-MM-DD format.',
+  },
+  envs: {
+    type: 'string',
+    description: 'Comma-separated execution environments, for example: staging,production.',
+  },
+};
+
+export const ANALYTICS_TOOLS = [
+  {
+    name: 'analytics_tests',
+    description:
+      `Enterprise analytics: list tests matching an analytics report (/api/v2/{project_id}/analytics/tests/{kind}). Requires api_analytics subscription feature. ${ANALYTICS_TESTS_TQL_REFERENCE}`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        kind: {
+          type: 'string',
+          enum: ANALYTICS_TEST_KINDS,
+          description: 'Test-level analytics report kind.',
+        },
+        q: {
+          type: 'string',
+          description: ANALYTICS_TESTS_TQL_INPUT_DESCRIPTION,
+        },
+        ...commonAnalyticsProperties,
+        page: {
+          type: 'integer',
+          minimum: 1,
+        },
+        per_page: {
+          type: 'integer',
+          minimum: 1,
+          maximum: 100,
+        },
+        min: {
+          type: 'number',
+          minimum: 0,
+          maximum: 1,
+          description: 'Flaky rate lower bound. Applies only to kind=flaky.',
+        },
+        max: {
+          type: 'number',
+          minimum: 0,
+          maximum: 1,
+          description: 'Flaky rate upper bound. Applies only to kind=flaky.',
+        },
+        threshold_ms: {
+          type: 'integer',
+          minimum: 11,
+          description: 'Duration threshold in milliseconds. Applies only to kind=slow.',
+        },
+        maturity_days: {
+          type: 'integer',
+          minimum: 0,
+          description: 'Minimum test age in days. Applies only to kind=never-executed.',
+        },
+        run: {
+          type: 'string',
+          description: 'Scope results to one run UID. Applies only to kind=flaky or kind=slow.',
+        },
+      },
+      required: ['kind'],
+      additionalProperties: false,
+    },
+  },
+  {
+    name: 'analytics_stats',
+    description:
+      `Enterprise analytics: fetch an aggregated analytics report (/api/v2/{project_id}/analytics/stats/{kind}). Requires api_analytics subscription feature. ${ANALYTICS_STATS_TQL_REFERENCE}`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        kind: {
+          type: 'string',
+          enum: ANALYTICS_STATS_KINDS,
+          description: 'Aggregated analytics report kind.',
+        },
+        q: {
+          type: 'string',
+          description: ANALYTICS_STATS_TQL_INPUT_DESCRIPTION,
+        },
+        ...commonAnalyticsProperties,
+      },
+      required: ['kind'],
+      additionalProperties: false,
+    },
+  },
+];
+
+export const ENTERPRISE_TOOL_DEFINITIONS = [
+  ...TOOL_DEFINITIONS,
+  ...ANALYTICS_TOOLS,
+];
+
+export function registerAnalyticsHandlers(handlers) {
+  handlers.analytics_tests = async (args = {}) => this.asText(await analyticsTests.call(this, args));
+  handlers.analytics_stats = async (args = {}) => this.asText(await analyticsStats.call(this, args));
+}
+
+function analyticsTests({
+  kind,
+  q,
+  days,
+  from,
+  to,
+  envs,
+  page,
+  per_page: perPage,
+  min,
+  max,
+  threshold_ms: thresholdMs,
+  maturity_days: maturityDays,
+  run,
+} = {}) {
+  return this.apiClient.list(`analytics/tests/${this.pickRequiredArg({ kind }, 'kind')}`, {
+    q,
+    days,
+    from,
+    to,
+    envs,
+    page,
+    per_page: perPage,
+    min,
+    max,
+    threshold_ms: thresholdMs,
+    maturity_days: maturityDays,
+    run,
+  });
+}
+
+function analyticsStats({ kind, q, days, from, to, envs } = {}) {
+  return this.apiClient.list(`analytics/stats/${this.pickRequiredArg({ kind }, 'kind')}`, {
+    q,
+    days,
+    from,
+    to,
+    envs,
+  });
+}

package/src/load-core.js

@@ -0,0 +1,29 @@
+async function loadCoreModule() {
+  try {
+    const installedCore = await import('@testomatio/mcp');
+    if (
+      installedCore &&
+      typeof installedCore.createApplication === 'function' &&
+      installedCore.ConfigurationError &&
+      Array.isArray(installedCore.TOOL_DEFINITIONS)
+    ) {
+      return installedCore;
+    }
+  } catch {
+    // Fall back to the local repo copy when testing from a checkout.
+  }
+
+  return import('../../../src/index.js');
+}
+
+const coreModule = await loadCoreModule();
+
+export const {
+  ANALYTICS_STATS_TQL_INPUT_DESCRIPTION,
+  ANALYTICS_STATS_TQL_REFERENCE,
+  ANALYTICS_TESTS_TQL_INPUT_DESCRIPTION,
+  ANALYTICS_TESTS_TQL_REFERENCE,
+  ConfigurationError,
+  TOOL_DEFINITIONS,
+  createApplication,
+} = coreModule;

package/src/main.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { ConfigurationError, createApplication } from './load-core.js';
+import { ENTERPRISE_TOOL_DEFINITIONS, registerAnalyticsHandlers } from './analytics.js';
+import { getPackageVersion } from './package-version.js';
+
+export function parseArgs(argv = process.argv) {
+  const command = new Command();
+
+  command
+    .name('testomatio-mcp-enterprise')
+    .description('Enterprise Model Context Protocol server for Testomat.io API v2')
+    .version(getPackageVersion())
+    .option('-t, --token <token>', 'Testomatio Project token')
+    .option('-p, --project <project>', 'Project ID')
+    .option('--base-url <url>', 'Base URL for Testomat.io API')
+    .parse(argv);
+
+  return command.opts();
+}
+
+export function createEnterpriseApplication(argvOptions = {}) {
+  return createApplication(argvOptions, {
+    tools: ENTERPRISE_TOOL_DEFINITIONS,
+    name: 'testomatio-mcp-enterprise-server',
+    registryOptions: {
+      handlerRegistrars: [registerAnalyticsHandlers],
+    },
+  });
+}
+
+export async function main(argv = process.argv) {
+  try {
+    const options = parseArgs(argv);
+    const app = createEnterpriseApplication(options);
+    await app.mcpServer.run();
+  } catch (error) {
+    if (error instanceof ConfigurationError) {
+      console.error(`Configuration error: ${error.message}`);
+      process.exit(1);
+    }
+
+    console.error('Failed to start enterprise server:', error.message || error);
+    process.exit(1);
+  }
+}

package/src/package-version.js

@@ -0,0 +1,19 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+let cachedVersion;
+
+export function getPackageVersion() {
+  if (cachedVersion) {
+    return cachedVersion;
+  }
+
+  const __filename = fileURLToPath(import.meta.url);
+  const __dirname = path.dirname(__filename);
+  const packageJsonPath = path.resolve(__dirname, '../package.json');
+  const raw = fs.readFileSync(packageJsonPath, 'utf8');
+  const pkg = JSON.parse(raw);
+  cachedVersion = pkg.version || '0.0.0';
+  return cachedVersion;
+}