@reftrixmcp/mcp-server 0.1.7

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "@reftrixmcp/mcp-server",
+  "version": "0.1.7",
+  "license": "AGPL-3.0-only",
+  "description": "MCP Server for Reftrix - AI agent integration for web design analysis, layout extraction, motion detection, and quality evaluation",
+  "files": [
+    "dist/",
+    "src/"
+  ],
+  "mcpName": "io.github.tkmd/reftrixmcp",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./services": {
+      "types": "./dist/services/index.d.ts",
+      "import": "./dist/services/index.js",
+      "require": "./dist/services/index.js"
+    },
+    "./tools/brief": {
+      "types": "./dist/tools/brief/index.d.ts",
+      "import": "./dist/tools/brief/index.js",
+      "require": "./dist/tools/brief/index.js"
+    },
+    "./config/redis": {
+      "types": "./dist/config/redis.d.ts",
+      "import": "./dist/config/redis.js",
+      "require": "./dist/config/redis.js"
+    },
+    "./queues/page-analyze-queue": {
+      "types": "./dist/queues/page-analyze-queue.d.ts",
+      "import": "./dist/queues/page-analyze-queue.js",
+      "require": "./dist/queues/page-analyze-queue.js"
+    }
+  },
+  "bin": {
+    "reftrix-mcp": "./dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@prisma/client": "^6.19.2",
+    "axe-core": "^4.10.2",
+    "bullmq": "^5.66.5",
+    "culori": "^4.0.2",
+    "dompurify": "^3.3.2",
+    "ioredis": "^5.9.2",
+    "jsdom": "^27.2.0",
+    "pixelmatch": "^6.0.0",
+    "pngjs": "^7.0.0",
+    "sharp": "^0.34.5",
+    "ws": "^8.18.0",
+    "zod": "^3.24.0",
+    "@reftrixmcp/core": "0.1.7",
+    "@reftrixmcp/database": "0.1.7",
+    "@reftrixmcp/ml": "0.1.7",
+    "@reftrixmcp/webdesign-core": "0.1.7"
+  },
+  "devDependencies": {
+    "@axe-core/playwright": "^4.11.0",
+    "@types/culori": "^4.0.1",
+    "@types/dompurify": "^3.2.0",
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^22.0.0",
+    "@types/pixelmatch": "^5.2.6",
+    "@types/sharp": "^0.32.0",
+    "jscpd": "^4.0.5",
+    "playwright": "^1.57.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^4.0.14",
+    "@reftrixmcp/config": "0.1.7"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TKMD/ReftrixMCP.git",
+    "directory": "apps/mcp-server"
+  },
+  "homepage": "https://github.com/TKMD/ReftrixMCP#readme",
+  "bugs": {
+    "url": "https://github.com/TKMD/ReftrixMCP/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "NODE_ENV=development tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:smoke": "vitest run --config vitest.smoke.config.ts",
+    "test:unit": "vitest run --exclude 'tests/smoke/**/*.test.ts' --exclude 'tests/integration/**/*.test.ts' --exclude 'tests/e2e/**/*.test.ts' --exclude 'tests/benchmark*/**/*.test.ts'",
+    "test:integration": "vitest run tests/integration",
+    "test:e2e": "playwright test",
+    "test:e2e:playwright": "playwright test",
+    "test:e2e:playwright:ui": "playwright test --ui",
+    "test:e2e:playwright:debug": "playwright test --debug",
+    "test:e2e:playwright:headed": "playwright test --headed",
+    "bench": "vitest bench --config vitest.benchmark.config.ts",
+    "bench:json": "vitest bench --config vitest.benchmark.config.ts --reporter=json --outputFile=./benchmark-results/results.json",
+    "generate:tools": "tsx scripts/generate-tool-list.ts",
+    "validate:tools": "tsx scripts/validate-tool-list.ts --ci",
+    "validate:docs": "tsx scripts/validate-tool-list.ts --check-docs",
+    "validate:all": "tsx scripts/validate-tool-list.ts --ci --check-docs",
+    "worker:start": "NODE_ENV=development NODE_OPTIONS='--max-old-space-size=4096' tsx src/scripts/start-workers.ts",
+    "worker:start:page": "NODE_ENV=development NODE_OPTIONS='--max-old-space-size=4096' tsx src/scripts/start-workers.ts --page",
+    "worker:start:quality": "NODE_ENV=development NODE_OPTIONS='--max-old-space-size=4096' tsx src/scripts/start-workers.ts --quality",
+    "check:embeddings": "tsx src/scripts/check-embedding-coverage.ts",
+    "backfill:embeddings": "NODE_OPTIONS='--max-old-space-size=8192 --expose-gc' tsx src/scripts/backfill-embeddings.ts",
+    "clean": "rm -rf dist node_modules .turbo"
+  }
+}

package/src/api/health.ts

@@ -0,0 +1,372 @@
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+
+/**
+ * ヘルスチェックAPI
+ *
+ * データベース、Redis、外部サービスの接続状態を確認し、
+ * システム全体のヘルスステータスを提供します。
+ *
+ * ステータス:
+ * - healthy: 全サービス正常
+ * - degraded: 一部サービスに問題
+ * - unhealthy: 重要サービスがダウン
+ */
+
+import { createLogger } from "../utils/logger";
+
+const healthLogger = createLogger("HealthCheck");
+
+/**
+ * サービスヘルスの詳細情報
+ */
+export interface ServiceHealth {
+  name: string;
+  status: "healthy" | "degraded" | "unhealthy";
+  responseTime: number;
+  details: Record<string, unknown>;
+}
+
+/**
+ * 基本ヘルスチェックレスポンス
+ */
+export interface BasicHealthResponse {
+  status: "healthy" | "degraded" | "unhealthy";
+  timestamp: string;
+  version: string;
+  uptime: number;
+}
+
+/**
+ * 詳細ヘルスチェックレスポンス
+ */
+export interface DetailedHealthResponse extends BasicHealthResponse {
+  dependencies: {
+    database: ServiceHealth;
+    redis: ServiceHealth;
+    externalServices: ServiceHealth[];
+  };
+}
+
+/**
+ * データベース接続チェッカーのインターフェース
+ */
+export interface DatabaseChecker {
+  checkConnection(): Promise<{ connected: boolean; version: string | null }>;
+}
+
+/**
+ * Redisチェッカーのインターフェース
+ */
+export interface RedisChecker {
+  checkConnection(): Promise<{ connected: boolean; version: string | null }>;
+}
+
+/**
+ * 外部サービスチェッカーのインターフェース
+ */
+export interface ExternalServiceChecker {
+  name: string;
+  checkHealth(): Promise<{ accessible: boolean; details?: Record<string, unknown> }>;
+}
+
+/**
+ * ヘルスチェックサービスの設定
+ */
+export interface HealthCheckConfig {
+  version: string;
+  databaseChecker?: DatabaseChecker;
+  redisChecker?: RedisChecker;
+  externalServiceCheckers?: ExternalServiceChecker[];
+}
+
+/**
+ * デフォルトのデータベースチェッカー（モック）
+ */
+class DefaultDatabaseChecker implements DatabaseChecker {
+  async checkConnection(): Promise<{ connected: boolean; version: string | null }> {
+    // 実際の実装ではPrismaクライアントを使用
+    return {
+      connected: true,
+      version: "18.1",
+    };
+  }
+}
+
+/**
+ * デフォルトのRedisチェッカー（モック）
+ */
+class DefaultRedisChecker implements RedisChecker {
+  async checkConnection(): Promise<{ connected: boolean; version: string | null }> {
+    // 実際の実装ではRedisクライアントを使用
+    return {
+      connected: true,
+      version: "7.2",
+    };
+  }
+}
+
+/**
+ * デフォルトの外部サービスチェッカー
+ */
+class DefaultExternalServiceChecker implements ExternalServiceChecker {
+  constructor(public name: string) {}
+
+  async checkHealth(): Promise<{ accessible: boolean; details?: Record<string, unknown> }> {
+    // 実際の実装ではHTTPリクエストを送信
+    return {
+      accessible: true,
+    };
+  }
+}
+
+/**
+ * ヘルスチェックサービス
+ *
+ * システム全体のヘルス状態を監視し、レポートします。
+ */
+export class HealthCheckService {
+  private version: string;
+  private databaseChecker: DatabaseChecker;
+  private redisChecker: RedisChecker;
+  private externalServiceCheckers: ExternalServiceChecker[];
+
+  constructor(config?: HealthCheckConfig) {
+    this.version = config?.version ?? "0.1.0";
+    this.databaseChecker = config?.databaseChecker ?? new DefaultDatabaseChecker();
+    this.redisChecker = config?.redisChecker ?? new DefaultRedisChecker();
+    this.externalServiceCheckers = config?.externalServiceCheckers ?? [
+      new DefaultExternalServiceChecker("S3"),
+      new DefaultExternalServiceChecker("OpenAI API"),
+    ];
+  }
+
+  /**
+   * 基本ヘルスチェックを実行
+   */
+  async checkBasicHealth(): Promise<BasicHealthResponse> {
+    return {
+      status: "healthy",
+      timestamp: new Date().toISOString(),
+      version: this.version,
+      uptime: process.uptime(),
+    };
+  }
+
+  /**
+   * 詳細ヘルスチェックを実行
+   */
+  async checkDetailedHealth(): Promise<DetailedHealthResponse> {
+    const database = await this.checkDatabase();
+    const redis = await this.checkRedis();
+    const externalServices = await this.checkExternalServices();
+
+    // ステータス判定
+    const allServices = [database, redis, ...externalServices];
+    const hasUnhealthy = allServices.some((s) => s.status === "unhealthy");
+    const hasDegraded = allServices.some((s) => s.status === "degraded");
+
+    let overallStatus: "healthy" | "degraded" | "unhealthy";
+    if (hasUnhealthy) {
+      overallStatus = "unhealthy";
+    } else if (hasDegraded) {
+      overallStatus = "degraded";
+    } else {
+      overallStatus = "healthy";
+    }
+
+    return {
+      status: overallStatus,
+      timestamp: new Date().toISOString(),
+      version: this.version,
+      uptime: process.uptime(),
+      dependencies: {
+        database,
+        redis,
+        externalServices,
+      },
+    };
+  }
+
+  /**
+   * データベース接続をチェック
+   */
+  async checkDatabase(): Promise<ServiceHealth> {
+    const startTime = Date.now();
+
+    try {
+      const result = await this.databaseChecker.checkConnection();
+      const responseTime = Date.now() - startTime;
+
+      return {
+        name: "PostgreSQL",
+        status: result.connected ? "healthy" : "unhealthy",
+        responseTime,
+        details: {
+          connected: result.connected,
+          version: result.version,
+        },
+      };
+    } catch (error) {
+      const responseTime = Date.now() - startTime;
+
+      healthLogger.error("Database check failed", error);
+
+      return {
+        name: "PostgreSQL",
+        status: "unhealthy",
+        responseTime,
+        details: {
+          connected: false,
+          version: null,
+          error: error instanceof Error ? error.message : "Unknown error",
+        },
+      };
+    }
+  }
+
+  /**
+   * Redis接続をチェック
+   */
+  async checkRedis(): Promise<ServiceHealth> {
+    const startTime = Date.now();
+
+    try {
+      const result = await this.redisChecker.checkConnection();
+      const responseTime = Date.now() - startTime;
+
+      return {
+        name: "Redis",
+        status: result.connected ? "healthy" : "unhealthy",
+        responseTime,
+        details: {
+          connected: result.connected,
+          version: result.version,
+        },
+      };
+    } catch (error) {
+      const responseTime = Date.now() - startTime;
+
+      healthLogger.error("Redis check failed", error);
+
+      return {
+        name: "Redis",
+        status: "unhealthy",
+        responseTime,
+        details: {
+          connected: false,
+          version: null,
+          error: error instanceof Error ? error.message : "Unknown error",
+        },
+      };
+    }
+  }
+
+  /**
+   * 外部サービスをチェック
+   */
+  async checkExternalServices(): Promise<ServiceHealth[]> {
+    const results: ServiceHealth[] = [];
+
+    for (const checker of this.externalServiceCheckers) {
+      const startTime = Date.now();
+
+      try {
+        const result = await checker.checkHealth();
+        const responseTime = Date.now() - startTime;
+
+        results.push({
+          name: checker.name,
+          status: result.accessible ? "healthy" : "unhealthy",
+          responseTime,
+          details: {
+            accessible: result.accessible,
+            ...result.details,
+          },
+        });
+      } catch (error) {
+        const responseTime = Date.now() - startTime;
+
+        healthLogger.error(`External service ${checker.name} check failed`, error);
+
+        results.push({
+          name: checker.name,
+          status: "unhealthy",
+          responseTime,
+          details: {
+            accessible: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+          },
+        });
+      }
+    }
+
+    return results;
+  }
+}
+
+/**
+ * ヘルスチェックエンドポイントのレスポンス型
+ */
+export interface HealthCheckEndpoint {
+  getBasicHealth(): Promise<{
+    statusCode: number;
+    body: BasicHealthResponse & { responseTime: number };
+  }>;
+  getDetailedHealth(): Promise<{
+    statusCode: number;
+    body: DetailedHealthResponse & { responseTime: number };
+  }>;
+}
+
+/**
+ * ヘルスチェックエンドポイントファクトリ
+ *
+ * HealthCheckServiceをラップしてHTTPレスポンス形式を提供
+ */
+export function createHealthCheckEndpoint(service: HealthCheckService): HealthCheckEndpoint {
+  return {
+    /**
+     * 基本ヘルスチェック（GET /api/health）
+     */
+    async getBasicHealth(): Promise<{
+      statusCode: number;
+      body: BasicHealthResponse & { responseTime: number };
+    }> {
+      const startTime = Date.now();
+      const health = await service.checkBasicHealth();
+      const responseTime = Date.now() - startTime;
+
+      return {
+        statusCode: 200,
+        body: {
+          ...health,
+          responseTime,
+        },
+      };
+    },
+
+    /**
+     * 詳細ヘルスチェック（GET /api/health/detailed）
+     */
+    async getDetailedHealth(): Promise<{
+      statusCode: number;
+      body: DetailedHealthResponse & { responseTime: number };
+    }> {
+      const startTime = Date.now();
+      const health = await service.checkDetailedHealth();
+      const responseTime = Date.now() - startTime;
+
+      return {
+        statusCode: health.status === "unhealthy" ? 503 : 200,
+        body: {
+          ...health,
+          responseTime,
+        },
+      };
+    },
+  };
+}
+
+// デフォルトエクスポート
+export default HealthCheckService;

package/src/config/index.ts

@@ -0,0 +1,12 @@
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+
+/**
+ * Configuration Module
+ *
+ * Central configuration management for Reftrix MCP Server
+ *
+ * @module config
+ */
+
+export * from "./redis";