mcp-prompt-optimizer 1.3.2 → 1.3.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-prompt-optimizer",
-  "version": "1.3.2",
-  "description": "Professional cloud-based MCP server for AI-powered prompt optimization with intelligent context detection, team collaboration, enterprise-grade features, startup validation, and robust API key management. Universal compatibility with Claude Desktop, Cursor, Windsurf, and 17+ MCP clients.",
+  "version": "1.3.3",
+  "description": "Professional cloud-based MCP server for AI-powered prompt optimization with intelligent context detection, personal model configuration via WebUI, team collaboration, enterprise-grade features, production resilience, and startup validation. Universal compatibility with Claude Desktop, Cursor, Windsurf, and 17+ MCP clients.",
   "main": "index.js",
   "bin": {
     "mcp-prompt-optimizer": "index.js"
@@ -9,10 +9,19 @@
   "scripts": {
     "start": "node index.js",
     "test": "node test-package.js",
+    "test:dev": "OPTIMIZER_DEV_MODE=true node test-package.js",
+    "test:offline": "OPTIMIZER_DEV_MODE=true OPTIMIZER_API_KEY=sk-dev-test-key node test-package.js",
     "validate": "node validate-structure.js",
     "check-status": "node lib/check-status.js",
     "validate-key": "node lib/validate-key.js",
-    "clear-cache": "node lib/clear-cache.js"
+    "clear-cache": "node lib/clear-cache.js",
+    "test-integration": "node lib/test-integration.js",
+    "test-integration:dev": "OPTIMIZER_DEV_MODE=true node lib/test-integration.js",
+    "diagnose": "node lib/diagnose.js",
+    "dev": "OPTIMIZER_DEV_MODE=true OPTIMIZER_API_KEY=sk-dev-test-key node index.js",
+    "dev:mock": "NODE_ENV=development OPTIMIZER_DEV_MODE=true OPTIMIZER_API_KEY=sk-dev-mock-key node index.js",
+    "health-check": "node -e \"console.log('Package health check passed')\"",
+    "reset-cache": "node lib/clear-cache.js && echo 'Cache and health data cleared'"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.15.1",
@@ -29,6 +38,9 @@
     "ai",
     "claude",
     "anthropic",
+    "openrouter",
+    "model-configuration",
+    "personal-models",
     "cursor",
     "windsurf",
     "cline",
@@ -48,7 +60,11 @@
     "caching",
     "robust-error-handling",
     "cli-commands",
-    "professional-tooling"
+    "professional-tooling",
+    "network-resilience",
+    "production-ready",
+    "development-mode",
+    "fallback-support"
   ],
   "author": "Prompt Optimizer Team <support@promptoptimizer.help>",
   "license": "SEE LICENSE IN LICENSE",
@@ -75,6 +91,11 @@
     "cli_commands": true,
     "caching_support": true,
     "offline_fallback": true,
+    "backend_aligned": true,
+    "personal_model_configuration": true,
+    "production_ready": true,
+    "network_resilience": true,
+    "development_mode": true,
     "capabilities": {
       "tools": true,
       "resources": false,
@@ -94,7 +115,13 @@
       "api_key_management": true,
       "offline_caching": true,
       "robust_error_handling": true,
-      "professional_cli": true
+      "professional_cli": true,
+      "personal_model_selection": true,
+      "openrouter_integration": true,
+      "network_resilience": true,
+      "fallback_modes": true,
+      "development_support": true,
+      "mock_optimization": true
     }
   },
   "cli": {
@@ -106,7 +133,8 @@
           "quota_status",
           "api_key_validation",
           "plan_details",
-          "troubleshooting"
+          "troubleshooting",
+          "network_health"
         ]
       },
       "validate-key": {
@@ -115,25 +143,53 @@
         "features": [
           "backend_validation",
           "format_checking",
-          "quota_testing"
+          "quota_testing",
+          "development_mode_support"
         ]
       },
       "clear-cache": {
-        "description": "Clear validation cache for fresh API key validation",
+        "description": "Clear validation cache and network health data for fresh validation",
         "usage": "mcp-prompt-optimizer clear-cache",
         "features": [
           "cache_clearing",
+          "health_data_reset",
           "fresh_validation",
           "troubleshooting"
         ]
       },
+      "test": {
+        "description": "Test backend integration and API connectivity with resilience testing",
+        "usage": "mcp-prompt-optimizer test",
+        "features": [
+          "backend_connectivity",
+          "api_validation",
+          "response_testing",
+          "fallback_testing",
+          "development_mode_testing"
+        ]
+      },
+      "diagnose": {
+        "description": "Run comprehensive diagnostic for troubleshooting with network analysis",
+        "usage": "mcp-prompt-optimizer diagnose",
+        "features": [
+          "system_check",
+          "cache_analysis",
+          "connectivity_test",
+          "configuration_validation",
+          "network_health_analysis",
+          "development_mode_detection"
+        ]
+      },
       "help": {
         "description": "Show detailed help information and setup instructions",
         "usage": "mcp-prompt-optimizer help",
         "features": [
           "setup_guide",
           "pricing_info",
-          "client_configuration"
+          "client_configuration",
+          "model_configuration_guide",
+          "development_mode_guide",
+          "troubleshooting_guide"
         ]
       },
       "version": {
@@ -141,7 +197,18 @@
         "usage": "mcp-prompt-optimizer version",
         "features": [
           "version_info",
-          "service_status"
+          "service_status",
+          "feature_summary"
+        ]
+      },
+      "dev": {
+        "description": "Start in development mode with mock backend",
+        "usage": "npm run dev",
+        "features": [
+          "offline_operation",
+          "mock_optimization",
+          "no_backend_required",
+          "development_testing"
         ]
       }
     },
@@ -149,7 +216,12 @@
       "mcp-prompt-optimizer check-status",
       "mcp-prompt-optimizer validate-key",
       "mcp-prompt-optimizer clear-cache",
-      "OPTIMIZER_API_KEY=sk-opt-xxx mcp-prompt-optimizer check-status"
+      "mcp-prompt-optimizer test",
+      "mcp-prompt-optimizer diagnose",
+      "OPTIMIZER_API_KEY=sk-opt-xxx mcp-prompt-optimizer check-status",
+      "OPTIMIZER_DEV_MODE=true mcp-prompt-optimizer test",
+      "npm run dev",
+      "npm run test:offline"
     ],
     "troubleshooting": {
       "common_issues": [
@@ -157,7 +229,12 @@
         "Network connectivity testing",
         "Cache management",
         "Quota status checking",
-        "Backend validation errors"
+        "Backend validation errors",
+        "Model configuration guidance",
+        "Development mode setup",
+        "Fallback mode operation",
+        "DNS resolution issues",
+        "Firewall/proxy configuration"
       ],
       "support_url": "https://promptoptimizer-blog.vercel.app/docs/troubleshooting"
     }
@@ -168,7 +245,7 @@
     "trial": {
       "available": true,
       "optimizations": 5,
-      "description": "Free trial with full feature access including CLI tools"
+      "description": "Free trial with full feature access including CLI tools and model configuration"
     },
     "plans": {
       "explorer": {
@@ -181,11 +258,15 @@
           "intelligent_optimization",
           "template_management",
           "web_ui_access",
+          "personal_model_configuration",
+          "openrouter_integration",
           "community_support",
           "cloud_processing",
           "startup_validation",
           "api_key_management",
-          "cli_tools"
+          "cli_tools",
+          "network_resilience",
+          "development_mode"
         ],
         "description": "Perfect for individual developers and prompt engineers"
       },
@@ -202,12 +283,16 @@
           "optimization_insights",
           "priority_processing",
           "analytics_dashboard",
+          "personal_model_configuration",
+          "openrouter_integration",
           "email_support",
           "cloud_processing",
           "startup_validation",
           "api_key_management",
           "offline_caching",
-          "advanced_cli_tools"
+          "advanced_cli_tools",
+          "network_resilience",
+          "development_mode"
         ],
         "description": "For creators and small teams with professional workflows",
         "popular": true
@@ -228,12 +313,18 @@
           "team_management",
           "priority_support",
           "dedicated_support_channel",
+          "personal_model_configuration",
+          "openrouter_integration",
+          "premium_model_access",
           "cloud_processing",
           "startup_validation",
           "api_key_management",
           "offline_caching",
           "enterprise_features",
-          "professional_cli_suite"
+          "professional_cli_suite",
+          "network_resilience",
+          "development_mode",
+          "fallback_guarantees"
         ],
         "description": "For growing teams and agencies with high-volume needs"
       }
@@ -280,9 +371,53 @@
       "usage_tracking": true,
       "startup_validation": true,
       "api_key_management": true,
-      "professional_cli": true
+      "professional_cli": true,
+      "personal_model_selection": true,
+      "openrouter_integration": true,
+      "network_health_monitoring": true,
+      "intelligent_fallback": true,
+      "development_mode_support": true
     }
   },
+  "model_configuration": {
+    "supports_personal_models": true,
+    "configuration_method": "webui_dashboard",
+    "supported_providers": ["openrouter"],
+    "model_types": {
+      "optimization_model": {
+        "description": "Model used for prompt optimization",
+        "examples": [
+          "anthropic/claude-3-5-sonnet",
+          "openai/gpt-4o-mini",
+          "google/gemini-pro-1.5"
+        ]
+      },
+      "evaluation_model": {
+        "description": "Model used for quality assessment",
+        "examples": [
+          "google/gemini-pro-1.5",
+          "openai/gpt-3.5-turbo",
+          "anthropic/claude-3-haiku"
+        ]
+      }
+    },
+    "api_key_structure": {
+      "service_key": {
+        "format": "sk-opt-* or sk-team-*",
+        "purpose": "MCP service subscription access"
+      },
+      "development_key": {
+        "format": "sk-dev-* or sk-local-*",
+        "purpose": "Development and testing (no backend required)"
+      },
+      "openrouter_key": {
+        "format": "OpenRouter API key",
+        "purpose": "Personal model usage (configured in WebUI)",
+        "optional": true
+      }
+    },
+    "configuration_url": "https://promptoptimizer-blog.vercel.app/dashboard"
+  },
   "compatibility": {
     "mcp_clients": [
       "Claude Desktop",
@@ -307,18 +442,25 @@
       "macos": true,
       "linux": true,
       "wsl": true
+    },
+    "network_environments": {
+      "corporate_firewalls": true,
+      "proxy_servers": true,
+      "air_gapped": true,
+      "mobile_networks": true
     }
   },
   "api_requirements": {
     "required_keys": [
       {
         "name": "OPTIMIZER_API_KEY",
-        "format": "sk-opt-* or sk-team-*",
-        "description": "Cloud API key from promptoptimizer-blog.vercel.app/pricing",
+        "format": "sk-opt-*, sk-team-*, sk-dev-*, or sk-local-*",
+        "description": "Cloud API key from promptoptimizer-blog.vercel.app/pricing or development key for testing",
         "required": true,
         "validation": "startup_and_runtime",
-        "caching": "24_hours",
-        "offline_fallback": true
+        "caching": "24_hours_normal_7_days_fallback",
+        "offline_fallback": true,
+        "development_support": true
       }
     ],
     "optional_keys": [
@@ -327,25 +469,76 @@
         "description": "Custom backend URL (defaults to production)",
         "required": false,
         "default": "https://p01--project-optimizer--fvrdk8m9k9j.code.run"
+      },
+      {
+        "name": "OPTIMIZER_DEV_MODE",
+        "description": "Enable development mode (true/false)",
+        "required": false,
+        "default": "false",
+        "development_feature": true
+      },
+      {
+        "name": "OPTIMIZER_REQUEST_TIMEOUT",
+        "description": "Request timeout in milliseconds",
+        "required": false,
+        "default": "30000"
       }
-    ]
+    ],
+    "webui_configuration": {
+      "openrouter_api_key": {
+        "description": "Personal OpenRouter API key configured via WebUI dashboard",
+        "required": false,
+        "configuration_url": "https://promptoptimizer-blog.vercel.app/dashboard"
+      },
+      "model_preferences": {
+        "description": "Personal model selection configured via WebUI",
+        "automatic_inheritance": true
+      }
+    }
   },
   "architecture": {
     "pattern": "cloud_based_mcp_server",
-    "alignment": "local_mcp_server_patterns",
+    "alignment": "backend_api_compliant",
     "startup_validation": true,
     "error_handling": "comprehensive",
-    "caching_strategy": "validation_results_24h",
+    "caching_strategy": "intelligent_multi_tier",
     "offline_support": "graceful_degradation",
     "cli_integration": "full_featured",
-    "backend_communication": "standardized_headers"
+    "backend_communication": "resilient_with_fallback",
+    "model_configuration_flow": "webui_to_mcp_automatic",
+    "network_resilience": "production_grade",
+    "development_support": "comprehensive"
+  },
+  "resilience": {
+    "network_handling": {
+      "retry_strategy": "exponential_backoff_with_jitter",
+      "max_retries": 5,
+      "timeout_handling": "progressive",
+      "dns_failure_recovery": true,
+      "connection_pooling": false,
+      "circuit_breaker": false
+    },
+    "caching_strategy": {
+      "validation_cache": "24_hours",
+      "fallback_cache": "7_days",
+      "health_monitoring": "continuous",
+      "cache_invalidation": "intelligent"
+    },
+    "fallback_modes": {
+      "mock_responses": true,
+      "cached_validation": true,
+      "offline_operation": true,
+      "reduced_functionality": true
+    }
   },
   "quality": {
     "error_handling": "enterprise_grade",
     "user_experience": "professional",
     "troubleshooting": "guided_resolution",
     "documentation": "comprehensive",
-    "testing": "automated_validation"
+    "testing": "automated_validation",
+    "network_resilience": "production_ready",
+    "development_support": "full_featured"
   },
   "support": {
     "email": "support@promptoptimizer.help",
@@ -355,6 +548,9 @@
     "status_page": "https://status.promptoptimizer.help",
     "community": "https://github.com/prompt-optimizer/mcp-prompt-optimizer/discussions",
     "troubleshooting": "https://promptoptimizer-blog.vercel.app/docs/troubleshooting",
-    "cli_guide": "https://promptoptimizer-blog.vercel.app/docs/cli"
+    "cli_guide": "https://promptoptimizer-blog.vercel.app/docs/cli",
+    "model_configuration_guide": "https://promptoptimizer-blog.vercel.app/docs/model-configuration",
+    "development_guide": "https://promptoptimizer-blog.vercel.app/docs/development",
+    "network_troubleshooting": "https://promptoptimizer-blog.vercel.app/docs/network-issues"
   }
-}
+}