mcp-prompt-optimizer 1.0.2 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,84 @@ All notable changes to the MCP Prompt Optimizer package will be documented in th
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2025-06-21
+
+### Added
+- **MAJOR**: AI Context Detection and Enhanced Optimization
+  - Automatic AI context detection for prompts (image_generation, llm_interaction, technical_automation, human_communication)
+  - Enhanced goal mapping with AI-specific optimization goals
+  - Parameter preservation for technical prompts (e.g., Midjourney --ar, --v parameters)
+  - Context-aware optimization routing based on prompt content
+
+### New Features
+- **AI-Specific Optimization Goals**:
+  - `keyword_density` - Enhanced keyword optimization for AI models
+  - `parameter_preservation` - Preserves technical parameters during optimization
+  - `token_efficiency` - Optimizes token usage for LLM interactions
+  - `embedding_strength` - Enhances semantic embedding effectiveness
+  - `context_specificity` - Improves context relevance for AI models
+  - `ai_model_compatibility` - Optimizes for specific AI model requirements
+  - `quality_enhancement` - Adds quality indicators for better AI responses
+  - `role_clarity` - Enhances role-playing and persona clarity
+  - `code_protection` - Protects code elements during optimization
+
+- **Enhanced Tool Parameters**:
+  - `ai_context` - Manual AI context specification (auto-detected if not provided)
+  - `preserve_formatting` - Controls technical parameter preservation
+  - `target_ai_model` - Specify target AI model for optimization
+  - `optimization_level` - Choose between conservative, balanced, or aggressive optimization
+
+### Improved
+- **Enhanced Response Information**:
+  - Shows detected AI context in optimization results
+  - Displays optimization strategy used
+  - Indicates when goal enhancement was applied
+  - Reports preserved parameters count
+  - Shows original vs enhanced goals comparison
+
+- **Better AI Integration**:
+  - Automatic detection of Midjourney, DALL-E, and Stable Diffusion prompts
+  - Smart handling of LLM role-playing prompts
+  - Code and technical automation prompt protection
+  - Context-aware optimization strategies
+
+### Technical Improvements
+- Updated MCP server version to 1.1.0
+- Enhanced API client with AI optimization options
+- Improved error handling for AI-specific features
+- Added comprehensive AI context validation
+
+### Documentation
+- Updated tool schema with new AI-specific parameters
+- Enhanced descriptions for all new optimization goals
+- Added AI context detection documentation
+- Improved examples with AI optimization use cases
+
+### Backward Compatibility
+- All existing functionality remains unchanged
+- New AI features are automatically applied when beneficial
+- Existing goal names and functionality preserved
+- No breaking changes to API or configuration
+
+## [1.0.3] - 2025-06-18
+
+### Fixed
+- **CRITICAL**: Fixed binary execution issue on Windows systems
+  - Changed binary configuration to point directly to index.js instead of bin/start-server
+  - Resolved issue where global installation commands (--help, --version) failed silently
+  - Improved version detection for global installations
+  - Fixed Windows batch file generation issues
+
+### Improved
+- Enhanced binary path resolution for global installations
+- Added fallback version detection when package.json path resolution fails
+- Better error handling in binary execution
+
+### Notes
+- This fix resolves the issue where `mcp-prompt-optimizer --help` and `mcp-prompt-optimizer --version` returned no output
+- Existing functionality remains unchanged
+- No breaking changes to API or configuration
+
 ## [1.0.2] - 2025-06-18
 
 ### Fixed
@@ -86,14 +164,74 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Backend Compatibility
 
-| Package Version | Backend API Version | Deployment URL |
-|-----------------|--------------------|--------------------|
-| 1.0.2 | v0.2.2+ | https://p01--project-optimizer--fvrdk8m9k9j.code.run |
-| 1.0.1 | v0.2.2+ | https://p01--project-optimizer--fvrdk8m9k9j.code.run |
-| 1.0.0 | v0.2.0+ | Placeholder URL (manual configuration required) |
+| Package Version | Backend API Version | Deployment URL | AI Features |
+|-----------------|--------------------|--------------------|-------------|
+| 1.1.0 | v0.3.0+ | https://p01--project-optimizer--fvrdk8m9k9j.code.run | Full AI Context Detection |
+| 1.0.3 | v0.2.2+ | https://p01--project-optimizer--fvrdk8m9k9j.code.run | None |
+| 1.0.2 | v0.2.2+ | https://p01--project-optimizer--fvrdk8m9k9j.code.run | None |
+| 1.0.1 | v0.2.2+ | https://p01--project-optimizer--fvrdk8m9k9j.code.run | None |
+| 1.0.0 | v0.2.0+ | Placeholder URL (manual configuration required) | None |
 
 ## Migration Guide
 
+### From 1.0.3 to 1.1.0
+
+**New AI Features Available:**
+- Automatic AI context detection
+- Enhanced optimization goals
+- Parameter preservation
+- Target AI model specification
+
+**Update process:**
+```bash
+# Update the package
+npm update -g mcp-prompt-optimizer
+
+# Verify new version and AI features
+mcp-prompt-optimizer --version
+
+# Test with an AI prompt (example)
+# The tool will now automatically detect and optimize for AI contexts
+```
+
+**New Usage Examples:**
+```json
+// Image generation prompt (auto-detected)
+{
+  "prompt": "A beautiful sunset over mountains --ar 16:9 --v 5.2",
+  "goals": ["clarity", "keyword_density"]
+}
+
+// LLM interaction prompt (auto-detected)  
+{
+  "prompt": "Act as a professional copywriter and help me write...",
+  "goals": ["role_clarity", "context_specificity"]
+}
+
+// Manual AI context specification
+{
+  "prompt": "Create a photorealistic image...", 
+  "ai_context": "image_generation",
+  "target_ai_model": "midjourney"
+}
+```
+
+### From 1.0.2 to 1.0.3
+
+No breaking changes. This update fixes binary execution issues on Windows systems.
+
+**Update process:**
+```bash
+# Update the package
+npm update -g mcp-prompt-optimizer
+
+# Verify new version and functionality
+mcp-prompt-optimizer --version
+mcp-prompt-optimizer --help
+
+# No configuration changes needed
+```
+
 ### From 1.0.1 to 1.0.2
 
 No breaking changes. This is a documentation-only update.
@@ -131,16 +269,52 @@ npm test
 
 ## Known Issues
 
-### 1.0.2
+### 1.1.0
+- None known at release time
+
+### 1.0.3
 - None known at release time
 
+### 1.0.2
+- Binary execution issues on Windows (fixed in 1.0.3)
+
 ### 1.0.1
 - Pricing documentation inconsistency (fixed in 1.0.2)
+- Binary execution issues on Windows (fixed in 1.0.3)
 
 ### 1.0.0
 - Required manual backend URL configuration
 - Placeholder URLs in documentation
 
+## AI Optimization Examples
+
+### Image Generation Prompts
+```javascript
+// Midjourney prompt with parameters preserved
+{
+  "prompt": "Professional headshot of a business executive --ar 1:1 --v 5.2 --stylize 100",
+  "goals": ["keyword_density", "parameter_preservation", "quality_enhancement"]
+}
+```
+
+### LLM Role-Playing
+```javascript
+// Role-playing prompt with enhanced clarity
+{
+  "prompt": "Act as a senior software architect and help me design...",
+  "goals": ["role_clarity", "context_specificity", "actionability"]
+}
+```
+
+### Technical Automation
+```javascript  
+// Code-related prompt with protection
+{
+  "prompt": "Write a Python function that processes API responses...",
+  "goals": ["code_protection", "technical_precision", "clarity"]
+}
+```
+
 ## Support
 
 For version-specific support:
@@ -153,4 +327,5 @@ When reporting issues, please include:
 - Node.js version (`node --version`)
 - Operating system
 - MCP client type and version
-- Error messages and logs
+- Error messages and logs
+- AI context and optimization goals used (for AI-related issues)

package/README.md

@@ -1,12 +1,21 @@
 # MCP Prompt Optimizer
 
-Local MCP server for accessing the Prompt Optimizer API from Claude Desktop, Cursor, Windsurf, and other MCP-compatible clients.
+Local MCP server for accessing the AI-Enhanced Prompt Optimizer API from Claude Desktop, Cursor, Windsurf, and other MCP-compatible clients.
+
+## ✨ New in v1.1.0: AI Context Detection & Enhanced Optimization
+
+- 🧠 **Automatic AI Context Detection** - Automatically detects image generation, LLM interaction, and technical automation prompts
+- 🛡️ **Parameter Preservation** - Preserves technical parameters like Midjourney `--ar 16:9`, `--v 5.2` during optimization
+- 🎯 **Enhanced AI Goals** - New optimization goals specifically designed for AI model interactions
+- 🤖 **Smart Goal Enhancement** - Automatically adds relevant goals based on detected AI context
+- 🔧 **Target AI Model Support** - Optimize specifically for Midjourney, ChatGPT, Claude, and more
 
 ## Features
 
 - 🤖 **Universal MCP Support** - Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client
 - 🔐 **Secure API Key Authentication** - Uses your personal API key for secure access
-- 🎯 **Advanced Optimization Goals** - Support for clarity, conciseness, technical accuracy, and more
+- 🧠 **AI Context Awareness** - Automatically detects and optimizes for different AI use cases
+- 🎯 **Advanced Optimization Goals** - Support for clarity, conciseness, technical accuracy, and AI-specific enhancements
 - 📊 **Real-time Quota Tracking** - See your usage and remaining quota
 - 💾 **Automatic Template Saving** - All optimizations saved with rich metadata for future reference
 - 🚀 **Easy Setup** - Simple configuration process
@@ -89,62 +98,74 @@ Add via Windsurf settings or configuration file:
 }
 ```
 
-### 4. Use the Tool
-
-Once configured, the `optimize_prompt` tool will be available in your MCP client. You can:
-
-- **prompt** (required): The prompt you want to optimize
-- **goals** (optional): Array of optimization goals
-
-## Template Saving & History
-
-Your optimizations are automatically saved as templates for comprehensive tracking and future reference:
-
-### Automatic Template Saving
-- **Every Optimization Saved**: All successful optimizations are automatically saved as structured templates
-- **Rich Metadata**: Templates include timestamps, optimization goals, confidence scores, and model information
-- **Request Tracking**: Each optimization includes unique request IDs for audit trails
-- **User Association**: Templates are linked to your account for privacy and organization
-
-### Template Structure
-Each saved template contains:
-```json
-{
-  "saved_at_utc": "2025-06-05T12:00:00.000Z",
-  "optimization_tier": "LLM",
-  "confidence_score": 0.95,
-  "original_prompt": "Your original prompt",
-  "optimized_prompt": "The improved version",
-  "optimization_goals": ["clarity", "technical_accuracy"],
-  "context_snapshot": {
-    "domain": "General",
-    "target_audience": "Default"
-  },
-  "request_id": "unique-request-identifier",
-  "request_metadata": {
-    "api_request_type": "POST_non_streaming",
-    "user_id": "your-user-id"
-  },
-  "model_optimized_with": "openai/gpt-4o-mini"
-}
-```
-
-### Template Access
-- **Dashboard Access**: View your optimization history at [the dashboard](https://promptoptimizer-blog.vercel.app/dashboard)
-- **Server-Side Storage**: Templates are securely stored on the backend infrastructure
-- **Privacy Protected**: Only you can access your templates through authenticated sessions
-- **Export Capability**: Templates can be exported through the web dashboard
-
-### Template Benefits
-- **Learning Tool**: Review how different goals affect optimization outcomes
-- **Consistency**: Maintain consistent optimization approaches across projects
-- **Analytics**: Track your optimization patterns and improvement over time
-- **Audit Trail**: Complete history of optimization requests for compliance and review
-
-## Optimization Goals
-
-Choose from these optimization strategies:
-
+### 4. Use the AI-Enhanced Tool
+
+Once configured, the `optimize_prompt` tool will be available with AI context detection:
+
+**Required Parameters:**
+- **prompt**: The prompt you want to optimize
+
+**Optional AI Enhancement Parameters:**
+- **goals**: Array of optimization goals (auto-enhanced based on AI context)
+- **ai_context**: Manual AI context specification (`image_generation`, `llm_interaction`, `technical_automation`, `human_communication`)
+- **preserve_formatting**: Whether to preserve technical parameters (default: true)
+- **target_ai_model**: Target AI model (`midjourney`, `chatgpt`, `claude`, etc.)
+- **optimization_level**: Optimization intensity (`conservative`, `balanced`, `aggressive`)
+
+## AI Context Detection
+
+The tool automatically detects and optimizes for different AI use cases:
+
+### 🎨 Image Generation
+**Automatically detected for:**
+- Midjourney prompts (`--ar 16:9`, `--v 5.2`, `--stylize 100`)
+- DALL-E prompts with photography/art terms
+- Stable Diffusion prompts with quality indicators
+
+**AI Enhancements Applied:**
+- Preserves technical parameters (`--ar`, `--v`, `--s`, `--q`)
+- Adds quality keywords (`award-winning`, `professional`, `masterpiece`)
+- Optimizes keyword density for better AI model response
+- Enhances technical precision
+
+### 🤖 LLM Interaction  
+**Automatically detected for:**
+- Role-playing prompts (`Act as a...`, `You are a...`)
+- Persona-based interactions
+- Character behavior instructions
+
+**AI Enhancements Applied:**
+- Clarifies role definitions and expectations
+- Improves context specificity
+- Optimizes token efficiency
+- Enhances actionability and response clarity
+
+### ⚙️ Technical Automation
+**Automatically detected for:**
+- Code generation requests
+- API and automation scripts
+- Technical documentation prompts
+
+**AI Enhancements Applied:**
+- Protects code elements from modification
+- Preserves technical parameters and URLs
+- Enhances technical precision
+- Maintains technical accuracy
+
+### 💬 Human Communication
+**Default for:**
+- General conversation prompts
+- Creative writing requests
+- Educational content
+
+**AI Enhancements Applied:**
+- Standard optimization rules
+- Clarity and conciseness improvements
+- Structural enhancements
+
+## Enhanced Optimization Goals
+
+### Standard Goals
 - **clarity** - Make the prompt clearer and more understandable
 - **conciseness** - Remove unnecessary words while preserving meaning
 - **technical_accuracy** - Improve technical precision and correctness
@@ -156,85 +177,205 @@ Choose from these optimization strategies:
 - **linguistic_precision** - Refine language for exact meaning
 - **holistic_effectiveness** - Overall optimization for best results
 
+### 🆕 AI-Specific Goals
+- **keyword_density** - Enhanced keyword optimization for AI models
+- **parameter_preservation** - Preserves technical parameters during optimization
+- **token_efficiency** - Optimizes token usage for LLM interactions  
+- **embedding_strength** - Enhances semantic embedding effectiveness
+- **context_specificity** - Improves context relevance for AI models
+- **ai_model_compatibility** - Optimizes for specific AI model requirements
+- **quality_enhancement** - Adds quality indicators for better AI responses
+- **role_clarity** - Enhances role-playing and persona clarity
+- **code_protection** - Protects code elements during optimization
+
 ## Example Usage
 
+### 🎨 Image Generation Example
+
 In Claude Desktop, you might ask:
 
+```
+Please optimize this Midjourney prompt using the optimize_prompt tool:
+"A beautiful sunset over mountains --ar 16:9 --v 5.2"
+
+Use goals: ["clarity", "keyword_density"]
+```
+
+**AI-Enhanced Result:**
+```
+# AI-Optimized Prompt
+
+Breathtaking golden hour sunset over majestic mountain peaks, dramatic lighting, award-winning landscape photography, professional composition, highly detailed, masterpiece quality --ar 16:9 --v 5.2
+
+---
+**Confidence Score:** 0.92
+**Goals Applied:** clarity, keyword_density, parameter_preservation, quality_enhancement
+**AI Context Detected:** image_generation
+**Optimization Strategy:** AI_PARAMETER_PRESERVATION
+**Parameters Preserved:** 2
+**Goal Enhancement:** Applied
+**Original Goals:** clarity, keyword_density
+**Enhanced Goals:** clarity, keyword_density, parameter_preservation, quality_enhancement
+**Quota Remaining:** 195/200
+```
+
+### 🤖 LLM Role-Playing Example
+
 ```
 Please optimize this prompt using the optimize_prompt tool:
-"Write me some code for a login system"
+"Act as a copywriter and help me write"
 
-Use goals: ["clarity", "specificity", "technical_accuracy"]
+Use goals: ["clarity", "specificity"]
 ```
 
-The tool will return an optimized version like:
+**AI-Enhanced Result:**
+```
+# AI-Optimized Prompt
+
+You are a professional copywriter with 10+ years of experience in digital marketing and persuasive writing. Please help me create compelling copy by:
+
+1. Understanding my target audience and objectives
+2. Applying proven copywriting frameworks (AIDA, PAS, etc.)
+3. Crafting persuasive, conversion-focused content
+4. Ensuring brand voice consistency and engagement
+
+What specific copywriting project would you like assistance with today?
+
+---
+**Confidence Score:** 0.89
+**Goals Applied:** clarity, specificity, role_clarity, context_specificity, actionability
+**AI Context Detected:** llm_interaction
+**Optimization Strategy:** RULES_WITH_LLM_FALLBACK
+**Goal Enhancement:** Applied
+**Quota Remaining:** 194/200
+```
+
+### ⚙️ Technical Automation Example
+
+```
+Please optimize this prompt using the optimize_prompt tool:
+"Write Python code for API"
 
+Use goals: ["technical_accuracy", "specificity"]
 ```
-Create a secure user authentication system with the following specifications:
+
+**AI-Enhanced Result:**
+```
+# AI-Optimized Prompt
+
+Create a Python REST API implementation with the following specifications:
 
 ## Requirements:
-- Implement login functionality with username/email and password
-- Include proper input validation and sanitization  
-- Add password hashing using bcrypt or similar
-- Implement session management
-- Include error handling for invalid credentials
-- Add rate limiting to prevent brute force attacks
+- Use FastAPI framework for modern async API development
+- Implement CRUD operations for data management
+- Include proper request/response models with Pydantic validation
+- Add comprehensive error handling and status codes
+- Implement authentication and authorization middleware
+- Include API documentation with OpenAPI/Swagger
 
 ## Deliverables:
-- Backend authentication logic
-- Frontend login form
-- Database schema for user accounts
-- Security best practices implementation
+- Main application file with API endpoints
+- Data models and validation schemas
+- Database integration layer
+- Authentication system
+- Unit tests for all endpoints
+- Documentation and usage examples
+
+Please specify the API's purpose and data entities for customized implementation.
+
+---
+**Confidence Score:** 0.86
+**Goals Applied:** technical_accuracy, specificity, code_protection, technical_precision, parameter_preservation
+**AI Context Detected:** technical_automation
+**Optimization Strategy:** CODE_PROTECTION
+**Goal Enhancement:** Applied
+**Quota Remaining:** 193/200
+```
 
-Confidence Score: 0.87
-Quota Remaining: 195/200
+## Template Saving & History
+
+Your AI-optimized prompts are automatically saved as templates with enhanced metadata:
+
+### Automatic Template Saving
+- **Every Optimization Saved**: All successful optimizations are automatically saved as structured templates
+- **AI Context Metadata**: Templates include detected AI context and optimization strategies
+- **Parameter Preservation Tracking**: Records which technical parameters were preserved
+- **Goal Enhancement History**: Shows original vs enhanced goals
+- **Model Compatibility Info**: Tracks target AI model optimizations
+
+### Enhanced Template Structure
+Each saved template now contains AI-specific information:
+```json
+{
+  "saved_at_utc": "2025-06-21T12:00:00.000Z",
+  "optimization_tier": "AI_PARAMETER_PRESERVATION",
+  "confidence_score": 0.92,
+  "original_prompt": "A sunset --ar 16:9 --v 5.2",
+  "optimized_prompt": "Breathtaking golden hour sunset over majestic mountain peaks...",
+  "optimization_goals": ["clarity", "keyword_density", "parameter_preservation", "quality_enhancement"],
+  "ai_context": "image_generation",
+  "optimization_strategy": "AI_PARAMETER_PRESERVATION",
+  "preserved_parameters": 2,
+  "goal_enhancement_applied": true,
+  "original_goals": ["clarity", "keyword_density"],
+  "enhanced_goals": ["clarity", "keyword_density", "parameter_preservation", "quality_enhancement"],
+  "target_ai_model": "midjourney",
+  "context_snapshot": {
+    "domain": "Image Generation",
+    "target_audience": "AI Artists"
+  },
+  "request_id": "unique-ai-request-identifier",
+  "model_optimized_with": "AI-Aware Rules-Based"
+}
 ```
 
+### AI-Enhanced Template Benefits
+- **AI Context Learning**: Understand how different AI contexts affect optimization
+- **Parameter Preservation Tracking**: See which technical parameters are being preserved
+- **Goal Enhancement Analysis**: Learn how the system enhances goals based on AI context
+- **Model-Specific Optimization**: Track optimizations for specific AI models
+- **Strategy Effectiveness**: Monitor which optimization strategies work best for your use cases
+
 ## Subscription Tiers
 
-- **Explorer** ($2.99/month): 5,000 optimizations + 1 API key
-- **Creator** ($25.99/month): 18,000 optimizations + 3 API keys + Template history
-- **Innovator** ($69.99/month): 75,000 optimizations + up to 10 API keys + Advanced analytics
+- **Explorer** ($2.99/month): 5,000 AI-enhanced optimizations + 1 API key
+- **Creator** ($25.99/month): 18,000 optimizations + 3 API keys + Template history + AI analytics
+- **Innovator** ($69.99/month): 75,000 optimizations + up to 10 API keys + Advanced AI features + Priority support
 
 ## Backend Infrastructure
 
-This package connects to a production-grade backend infrastructure:
+This package connects to a production-grade AI-enhanced backend infrastructure:
 
-- **FastAPI Backend** - High-performance Python API server with async processing
+- **AI-Enhanced FastAPI Backend** - High-performance Python API server with AI context detection
 - **Northflank Hosting** - Enterprise cloud deployment platform with 99.9% uptime
-- **Supabase Database** - PostgreSQL database with real-time features and automatic backups
+- **Supabase Database** - PostgreSQL database with AI optimization metadata storage
 - **Stripe Integration** - Secure payment processing and subscription management
-- **Template Storage System** - Automatic optimization history with rich metadata
-- **Advanced Analytics** - Usage tracking, performance monitoring, and optimization insights
+- **AI Template Storage System** - Automatic optimization history with AI context metadata
+- **Advanced AI Analytics** - AI context detection analytics and optimization insights
 
-### Backend Endpoints
-- **Production API**: `https://p01--project-optimizer--fvrdk8m9k9j.code.run`
-- **Health Check**: `https://p01--project-optimizer--fvrdk8m9k9j.code.run/health`
-- **API Documentation**: Available through the web dashboard
-
-### Server Features
-- **Real-time Quota Tracking** - Live usage monitoring and limits
-- **Template Persistence** - Automatic saving with comprehensive metadata
-- **Rate Limiting** - Intelligent throttling to prevent abuse
-- **Security Monitoring** - Advanced threat detection and prevention
-- **Performance Optimization** - Sub-second response times for most requests
+### AI-Enhanced Backend Features
+- **Real-time AI Context Detection** - Automatic detection of image generation, LLM interaction, and technical prompts
+- **Parameter Preservation Engine** - Intelligent preservation of technical parameters
+- **Goal Enhancement System** - Automatic goal enhancement based on AI context
+- **Model-Specific Optimization** - Optimization strategies tailored for specific AI models
+- **AI Analytics Dashboard** - Insights into AI context detection and optimization effectiveness
 
 ## Commands
 
 ```bash
-# Start the MCP server (usually called by MCP client)
+# Start the AI-enhanced MCP server (usually called by MCP client)
 mcp-prompt-optimizer
 
 # Configure API key
 mcp-prompt-optimizer --setup
 
-# Show help
+# Show help with AI features
 mcp-prompt-optimizer --help
 
-# Show version
+# Show version (now v1.1.0 with AI features)
 mcp-prompt-optimizer --version
 
-# Test package functionality
+# Test AI-enhanced package functionality
 npm test
 ```
 
@@ -251,10 +392,17 @@ mcp-prompt-optimizer --setup
 
 1. Verify your internet connection
 2. Check that your API key is valid at [the dashboard](https://promptoptimizer-blog.vercel.app/dashboard)
-3. Ensure your subscription is active
+3. Ensure your subscription is active and supports AI features
 4. Try regenerating your API key from the dashboard
 5. Check backend status: `curl https://p01--project-optimizer--fvrdk8m9k9j.code.run/health`
 
+### AI Context Detection Issues
+
+1. Verify that your prompt contains AI-specific indicators (--ar, "act as", code blocks)
+2. Try manually specifying the `ai_context` parameter
+3. Check that `preserve_formatting` is set to `true` for technical prompts
+4. Review the optimization response for AI context detection results
+
 ### MCP Client Configuration
 
 1. Make sure the configuration file path is correct
@@ -267,7 +415,7 @@ mcp-prompt-optimizer --setup
 If you experience backend connectivity issues:
 
 ```bash
-# Test backend directly
+# Test AI-enhanced backend directly
 curl -X GET "https://p01--project-optimizer--fvrdk8m9k9j.code.run/health"
 
 # Test with your API key
@@ -279,14 +427,16 @@ curl -X POST "https://p01--project-optimizer--fvrdk8m9k9j.code.run/api/v1/valida
 
 Your API key is stored securely at:
 - **Windows**: `%USERPROFILE%\.prompt-optimizer\config.json`
-- **macOS/Linux**: `~/.prompt-optimizer/config.json`
+- **macOS/Linux**: `~/.prompt-optimizer\config.json`
 
 The configuration includes:
 ```json
 {
   "apiKey": "sk-opt-your-key-here",
   "backendUrl": "https://p01--project-optimizer--fvrdk8m9k9j.code.run",
-  "updatedAt": "2025-06-05T12:00:00.000Z"
+  "updatedAt": "2025-06-21T12:00:00.000Z",
+  "aiFeatures": true,
+  "version": "1.1.0"
 }
 ```
 
@@ -297,31 +447,36 @@ Override configuration with environment variables:
 - `PROMPT_OPTIMIZER_API_KEY`: Override stored API key
 - `PROMPT_OPTIMIZER_BACKEND_URL`: Override backend URL
 - `NODE_ENV`: Set to 'development' for debug logging
+- `AI_CONTEXT_DEBUG`: Enable AI context detection debugging
 
 Example:
 ```bash
-PROMPT_OPTIMIZER_API_KEY=sk-opt-your-key mcp-prompt-optimizer
+PROMPT_OPTIMIZER_API_KEY=sk-opt-your-key AI_CONTEXT_DEBUG=true mcp-prompt-optimizer
 ```
 
 ## API Compatibility
 
-This package is compatible with the FastAPI backend API version 0.2.2+ and supports:
+This package is compatible with the AI-Enhanced FastAPI backend API version 0.3.0+ and supports:
 
 - ✅ **MCP Protocol 2024-11-05** - Latest MCP specification
+- ✅ **AI Context Detection** - Automatic detection of image generation, LLM interaction, technical automation
+- ✅ **Parameter Preservation** - Technical parameter preservation during optimization
+- ✅ **Enhanced Goal Mapping** - Automatic goal enhancement based on AI context
+- ✅ **Target AI Model Support** - Model-specific optimization strategies
 - ✅ **API Key Authentication** - Secure `sk-opt-` format keys
 - ✅ **Base64 Config Encoding** - MCP protocol compliance
-- ✅ **Real-time Quota Tracking** - Usage monitoring with template saving
+- ✅ **Real-time Quota Tracking** - Usage monitoring with AI analytics
 - ✅ **Error Handling** - Comprehensive error responses
 - ✅ **Rate Limiting** - Automatic retry logic
-- ✅ **Template Persistence** - Automatic optimization history
+- ✅ **AI Template Persistence** - Automatic optimization history with AI metadata
 
 ## Intellectual Property
 
 - **Your Prompts, Your IP**: You retain full intellectual property rights over all prompts you create and optimize
-- **Service Provision**: We provide optimization as a service - we do not claim ownership over your content
-- **Template Storage**: Saved templates are for your reference and remain your intellectual property
-- **Privacy Protected**: Your prompts and templates are private and accessible only to your account
-- **Data Export**: You can export your optimization history and templates at any time
+- **Service Provision**: We provide AI-enhanced optimization as a service - we do not claim ownership over your content
+- **AI Template Storage**: Saved templates with AI metadata are for your reference and remain your intellectual property
+- **Privacy Protected**: Your prompts, AI contexts, and templates are private and accessible only to your account
+- **Data Export**: You can export your AI optimization history and templates at any time
 
 ## Support
 
@@ -329,22 +484,24 @@ This package is compatible with the FastAPI backend API version 0.2.2+ and suppo
 - 🎫 [Support Portal](https://promptoptimizer-blog.vercel.app/support)
 - 🐛 [Report Issues](https://github.com/prompt-optimizer/mcp-prompt-optimizer/issues)
 - 💬 [Community Discord](https://discord.gg/prompt-optimizer)
+- 🤖 [AI Features Guide](https://promptoptimizer-blog.vercel.app/docs/ai-features)
 
 ## Security
 
 - API keys are stored locally and never shared
-- All communication uses HTTPS encryption with the backend
+- All communication uses HTTPS encryption with the AI-enhanced backend
 - No prompt data is stored permanently beyond template history (which you control)
-- Full audit trail of API usage available in dashboard
+- AI context detection happens server-side with privacy protection
+- Full audit trail of AI optimization usage available in dashboard
 - Compliance with enterprise security standards
-- Template data encrypted at rest and in transit
+- AI template data encrypted at rest and in transit
 
 ## Development
 
 ### Testing
 
 ```bash
-# Run package tests
+# Run package tests (includes AI feature tests)
 npm test
 
 # Manual server test
@@ -361,12 +518,30 @@ cd mcp-prompt-optimizer
 # Install dependencies
 npm install
 
-# Test locally
+# Test locally with AI features
 npm test
 ```
 
 ## Changelog
 
+### v1.1.0 - AI Enhancement Release 🚀
+- 🧠 **NEW**: Automatic AI context detection for image generation, LLM interaction, and technical automation
+- 🛡️ **NEW**: Parameter preservation for technical prompts (Midjourney parameters, code blocks, URLs)
+- 🎯 **NEW**: 9 AI-specific optimization goals (keyword_density, parameter_preservation, etc.)
+- 🤖 **NEW**: Smart goal enhancement based on detected AI context
+- 🔧 **NEW**: Target AI model specification support
+- 📊 **NEW**: Enhanced optimization response with AI context information
+- ⚡ **IMPROVED**: Better optimization strategies for different AI use cases
+
+### v1.0.3
+- ✅ Fixed binary execution issue on Windows systems
+- ✅ Enhanced error handling for server responses
+- ✅ Improved version detection for global installations
+
+### v1.0.2
+- ✅ Fixed pricing information discrepancy in documentation
+- ✅ Improved documentation consistency across all package files
+
 ### v1.0.1
 - ✅ Updated backend URL to production deployment
 - ✅ Enhanced error handling for server responses
@@ -384,9 +559,9 @@ npm test
 
 **Commercial License** - This software is licensed for commercial use. See LICENSE file for details.
 
-**Your Content**: You retain full intellectual property rights over all prompts, templates, and content you create using this service.
+**Your Content**: You retain full intellectual property rights over all prompts, templates, and content you create using this AI-enhanced service.
 
 ---
 
 **Made with ❤️ by the Prompt Optimizer Team**  
-*Empowering better AI interactions through optimized prompts*
+*Empowering better AI interactions through intelligent, context-aware prompt optimization*

package/bin/start-server

@@ -1,2 +1,22 @@
 #!/usr/bin/env node
-require('../index.js');
+
+// More robust binary that handles global installation better
+const path = require('path');
+
+// Determine the correct path to index.js
+let indexPath;
+if (__dirname.includes('node_modules')) {
+    // Running from global installation
+    indexPath = path.join(__dirname, '..', 'index.js');
+} else {
+    // Running from local development
+    indexPath = path.join(__dirname, '..', 'index.js');
+}
+
+try {
+    require(indexPath);
+} catch (error) {
+    console.error('Failed to start MCP Prompt Optimizer:', error.message);
+    console.error('Please try: npm install -g mcp-prompt-optimizer@latest');
+    process.exit(1);
+}

package/index.js

@@ -2,6 +2,7 @@
 
 const MCPServer = require('./lib/mcp-protocol');
 const Config = require('./lib/config');
+const path = require('path');
 
 async function setup() {
   const readline = require('readline');
@@ -158,8 +159,32 @@ async function showHelp() {
 }
 
 async function showVersion() {
-  const packageJson = require('./package.json');
-  console.log(`mcp-prompt-optimizer v${packageJson.version}`);
+  try {
+    // Try multiple paths to find package.json when installed globally
+    let packageJson;
+    const possiblePaths = [
+      path.join(__dirname, 'package.json'),           // Local development
+      path.join(__dirname, '..', 'package.json'),     // When run from bin/
+      path.join(process.cwd(), 'package.json'),       // Current directory
+    ];
+    
+    for (const packagePath of possiblePaths) {
+      try {
+        packageJson = require(packagePath);
+        break;
+      } catch (e) {
+        continue;
+      }
+    }
+    
+    if (packageJson && packageJson.version) {
+      console.log(`mcp-prompt-optimizer v${packageJson.version}`);
+    } else {
+      console.log('mcp-prompt-optimizer v1.0.2 (version detection failed)');
+    }
+  } catch (error) {
+    console.log('mcp-prompt-optimizer v1.0.2 (version detection failed)');
+  }
 }
 
 // Main execution

package/lib/api-client.js

@@ -32,10 +32,19 @@ class PromptOptimizerApiClient {
     }
   }
 
-  async optimize(prompt, goals = ['clarity']) {
+  async optimize(prompt, goals = ['clarity'], options = {}) {
     try {
-      // Encode config as base64 (MCP protocol requirement)
-      const config = { prompt, goals };
+      // Enhanced config with AI optimization support
+      const config = { 
+        prompt, 
+        goals,
+        // Add new AI optimization options
+        ai_context: options.ai_context || null,
+        preserve_formatting: options.preserve_formatting !== false,
+        target_ai_model: options.target_ai_model || null,
+        optimization_level: options.optimization_level || "balanced"
+      };
+      
       const configB64 = Buffer.from(JSON.stringify(config)).toString('base64');
       
       const response = await this.client.post(`/api/v1/mcp/optimize?config=${encodeURIComponent(configB64)}`);

package/lib/mcp-protocol.js

@@ -5,7 +5,7 @@ class MCPServer {
     this.apiClient = new PromptOptimizerApiClient(apiKey);
     this.tools = [{
       name: "optimize_prompt",
-      description: "Optimize prompts for clarity, conciseness, and effectiveness using advanced AI techniques",
+      description: "Optimize prompts for clarity, conciseness, and effectiveness using advanced AI techniques with context awareness",
       inputSchema: {
         type: "object",
         properties: {
@@ -18,6 +18,7 @@ class MCPServer {
             items: { 
               type: "string",
               enum: [
+                // Standard goals
                 "clarity", 
                 "conciseness", 
                 "technical_accuracy", 
@@ -27,11 +28,41 @@ class MCPServer {
                 "structure", 
                 "technical_precision",
                 "linguistic_precision", 
-                "holistic_effectiveness"
+                "holistic_effectiveness",
+                // NEW: AI-specific goals
+                "keyword_density",
+                "parameter_preservation", 
+                "token_efficiency",
+                "embedding_strength",
+                "context_specificity",
+                "ai_model_compatibility",
+                "quality_enhancement",
+                "role_clarity",
+                "code_protection"
               ]
             },
-            description: "Optimization goals (default: clarity)",
+            description: "Optimization goals including AI-specific enhancements (default: clarity)",
             default: ["clarity"]
+          },
+          ai_context: {
+            type: "string",
+            enum: ["image_generation", "llm_interaction", "technical_automation", "human_communication"],
+            description: "AI context type for optimization routing (auto-detected if not specified)"
+          },
+          preserve_formatting: {
+            type: "boolean",
+            description: "Whether to preserve technical formatting and parameters",
+            default: true
+          },
+          target_ai_model: {
+            type: "string", 
+            description: "Target AI model (e.g., 'midjourney', 'chatgpt', 'claude')"
+          },
+          optimization_level: {
+            type: "string",
+            enum: ["conservative", "balanced", "aggressive"],
+            description: "Optimization level: conservative, balanced, or aggressive",
+            default: "balanced"
           }
         },
         required: ["prompt"]
@@ -42,10 +73,11 @@ class MCPServer {
   async initialize() {
     try {
       const userData = await this.apiClient.validateKey();
-      console.error(`✅ Connected to Prompt Optimizer API`);
+      console.error(`✅ Connected to Prompt Optimizer API (AI-Enhanced)`);
       console.error(`   Tier: ${userData.tier}`);
       console.error(`   Quota: ${userData.quota_used}/${userData.quota_limit} used`);
       console.error(`   Status: ${userData.subscription_status}`);
+      console.error(`   AI Features: Context Detection, Parameter Preservation, Enhanced Goals`);
       return true;
     } catch (error) {
       console.error(`❌ Failed to connect: ${error.message}`);
@@ -55,7 +87,14 @@ class MCPServer {
 
   async handleToolCall(name, args) {
     if (name === 'optimize_prompt') {
-      const { prompt, goals = ['clarity'] } = args;
+      const { 
+        prompt, 
+        goals = ['clarity'], 
+        ai_context = null,
+        preserve_formatting = true,
+        target_ai_model = null,
+        optimization_level = "balanced"
+      } = args;
       
       // Validate prompt
       if (!prompt || typeof prompt !== 'string' || prompt.trim().length === 0) {
@@ -68,11 +107,15 @@ class MCPServer {
         };
       }
 
-      // Validate goals
+      // Validate goals (including new AI-specific goals)
       const validGoals = [
         "clarity", "conciseness", "technical_accuracy", "contextual_relevance", 
         "specificity", "actionability", "structure", "technical_precision",
-        "linguistic_precision", "holistic_effectiveness"
+        "linguistic_precision", "holistic_effectiveness",
+        // AI-specific goals
+        "keyword_density", "parameter_preservation", "token_efficiency",
+        "embedding_strength", "context_specificity", "ai_model_compatibility",
+        "quality_enhancement", "role_clarity", "code_protection"
       ];
       
       const filteredGoals = goals.filter(goal => validGoals.includes(goal));
@@ -81,12 +124,44 @@ class MCPServer {
       }
       
       try {
-        const result = await this.apiClient.optimize(prompt.trim(), filteredGoals);
+        const options = {
+          ai_context,
+          preserve_formatting,
+          target_ai_model,
+          optimization_level
+        };
+        
+        const result = await this.apiClient.optimize(prompt.trim(), filteredGoals, options);
+        
+        // Enhanced response with AI context information
+        let responseText = `# AI-Optimized Prompt\n\n${result.optimized_prompt}\n\n---\n\n`;
+        responseText += `**Confidence Score:** ${result.confidence_score.toFixed(2)}\n`;
+        responseText += `**Goals Applied:** ${filteredGoals.join(', ')}\n`;
+        
+        // Add AI context information if available
+        if (result.metadata?.ai_context) {
+          responseText += `**AI Context Detected:** ${result.metadata.ai_context}\n`;
+        }
+        if (result.metadata?.optimization_strategy) {
+          responseText += `**Optimization Strategy:** ${result.metadata.optimization_strategy}\n`;
+        }
+        if (result.metadata?.goal_enhancement_applied) {
+          responseText += `**Goal Enhancement:** Applied\n`;
+        }
+        if (result.metadata?.preserved_parameters) {
+          responseText += `**Parameters Preserved:** ${result.metadata.preserved_parameters}\n`;
+        }
+        if (result.metadata?.original_goals && result.metadata?.enhanced_goals) {
+          responseText += `**Original Goals:** ${result.metadata.original_goals.join(', ')}\n`;
+          responseText += `**Enhanced Goals:** ${result.metadata.enhanced_goals.join(', ')}\n`;
+        }
+        
+        responseText += `**Quota Remaining:** ${result.metadata?.quota_remaining ?? 'Unknown'}`;
         
         return {
           content: [{
             type: "text",
-            text: `# Optimized Prompt\n\n${result.optimized_prompt}\n\n---\n\n**Confidence Score:** ${result.confidence_score.toFixed(2)}\n**Goals Applied:** ${filteredGoals.join(', ')}\n**Quota Remaining:** ${result.metadata?.quota_remaining ?? 'Unknown'}`
+            text: responseText
           }]
         };
       } catch (error) {
@@ -119,7 +194,7 @@ class MCPServer {
               },
               serverInfo: {
                 name: "mcp-prompt-optimizer",
-                version: "1.0.0"
+                version: "1.1.0" // Updated version for AI features
               }
             } 
           };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "mcp-prompt-optimizer",
-  "version": "1.0.2",
-  "description": "Local MCP server for Prompt Optimizer API",
+  "version": "1.1.0",
+  "description": "Local MCP server for AI-Enhanced Prompt Optimizer API with context awareness and parameter preservation",
   "main": "index.js",
   "preferGlobal": true,
   "bin": {
-    "mcp-prompt-optimizer": "./bin/start-server"
+    "mcp-prompt-optimizer": "index.js"
   },
   "scripts": {
     "start": "node index.js",
@@ -29,7 +29,14 @@
     "windsurf",
     "api",
     "northflank",
-    "fastapi"
+    "fastapi",
+    "ai-context",
+    "parameter-preservation",
+    "image-generation",
+    "llm-interaction",
+    "technical-automation",
+    "goal-enhancement",
+    "context-awareness"
   ],
   "author": "Prompt Optimizer Team <support@promptoptimizer.com>",
   "license": "SEE LICENSE IN LICENSE",