🌍 MCP Prompt Optimizer Local - Cross-Platform Edition

Advanced Local Prompt Intelligence Engine with complete privacy and sophisticated content analysis. Now with universal cross-platform support for Windows, macOS, and Linux.

🎬 Demo Video

See the MCP Prompt Optimizer Local in action! Watch our comprehensive demo:

🎥 Watch on YouTube

Complete installation and usage demonstration showing:

• ⚡ Quick cross-platform installation
• 🔑 License setup (Basic FREE + Pro $79 one-time)
• 🔧 MCP client configuration
• 🧠 Live prompt optimization examples
• 🤖 Dual-tier showcase (Rules + LLM)

🚀 Quick Start

1. Get Your Local License Key

Visit https://promptoptimizer.xyz/local-license to get your local license key.

2. Set Your License Key

# Option 1: Environment variable (recommended)
export OPTIMIZER_API_KEY="sk-local-basic-your-key-here"

# Option 2: Add to shell profile
echo 'export OPTIMIZER_API_KEY="sk-local-basic-your-key-here"' >> ~/.bashrc
source ~/.bashrc

3. Optional: Set OpenAI API Key (for LLM Enhancement)

# Optional: For enhanced LLM-powered optimization
export OPENAI_API_KEY="sk-proj-your-openai-key-here"

4. Install Globally

npm install -g mcp-prompt-optimizer-local

5. Verify Installation

mcp-prompt-optimizer-local --version
mcp-prompt-optimizer-local check-license

🎯 MCP Client Configuration

Claude Desktop (~/.claude/claude_desktop_config.json)

Basic Configuration (Rules-based optimization only):

{
  "mcpServers": {
    "prompt-optimizer-local": {
      "command": "mcp-prompt-optimizer-local",
      "env": {
        "OPTIMIZER_API_KEY": "sk-local-basic-your-key-here"
      }
    }
  }
}

Enhanced Configuration (Rules-based + LLM optimization):

{
  "mcpServers": {
    "prompt-optimizer-local": {
      "command": "mcp-prompt-optimizer-local",
      "env": {
        "OPTIMIZER_API_KEY": "sk-local-pro-your-key-here",
        "OPENAI_API_KEY": "sk-proj-your-openai-key-here"
      }
    }
  }
}

Cursor (Settings → Extensions → MCP)

{
  "mcpServers": {
    "prompt-optimizer-local": {
      "command": "mcp-prompt-optimizer-local",
      "env": {
        "OPTIMIZER_API_KEY": "sk-local-pro-your-key-here",
        "OPENAI_API_KEY": "sk-proj-your-openai-key-here"
      }
    }
  }
}

Windsurf (MCP Settings)

{
  "mcpServers": {
    "prompt-optimizer-local": {
      "command": "mcp-prompt-optimizer-local",
      "env": {
        "OPTIMIZER_API_KEY": "sk-local-pro-your-key-here",
        "OPENAI_API_KEY": "sk-proj-your-openai-key-here"
      }
    }
  }
}

🌍 Platform Support

| Platform | Architecture | Status | Auto-Install | |----------|-------------|--------|--------------| | 🪟 Windows | x64 | ✅ Production Ready | ✅ | | 🍎 macOS | Intel (x64) | ✅ Full Support | ✅ | | 🍎 macOS | Apple Silicon (M1/M2/M3+) | ✅ Full Support | ✅ | | 🐧 Linux | x64 | ✅ Full Support | ✅ | | 🐧 Linux | ARM64 | ✅ Full Support | ✅ |

Single command works everywhere! The installer automatically:

• Detects your platform and architecture
• Downloads the correct native binary
• Verifies integrity with SHA256 checksums
• Sets proper permissions and validates installation

🛡️ Security Features

• 🔑 License Key Authentication - Prevents unauthorized usage
• 🔍 Binary Integrity Verification - SHA256 hash validation
• 🚪 Multi-Gate Installation - Four-layer security validation
• 🏠 100% Local Processing - Complete privacy, no data collection
• 🛡️ Tamper Detection - Detects modified or corrupted binaries

🎯 Key Features

• 🧠 Intelligent Content Analysis - Advanced prompt optimization
• 🔧 Technical Parameter Preservation - Maintains code and technical details
• 🐛 Debugging Scenario Detection - Context-aware optimization
• 📝 Template Management - Save and reuse optimization patterns
• 🤖 Dual Optimization Tiers:
  • Rules-based: Sophisticated AI-aware optimization (always available)
  • LLM-enhanced: OpenAI-powered optimization (requires OPENAI_API_KEY)
• ⚡ Performance Optimized - fast local startup, sub-second optimization on typical prompts

💰 Licensing Options

Basic License - FREE

• ✅ 5 optimizations/day - Perfect for trying the platform
• ✅ Complete privacy - No data transmission
• ✅ Rules-based optimization - Sophisticated AI-aware engine
• ✅ Local processing - Runs entirely on your machine

Pro License - $79 One-Time

• ✅ Unlimited optimizations - No daily limits
• ✅ Enhanced algorithms - Advanced optimization techniques
• ✅ Priority binary updates - Latest optimization improvements
• ✅ Extended offline operation - 48h license caching
• ✅ LLM enhancement support - Works with OpenAI API

📖 Usage Examples

Basic Optimization

# Start MCP server
mcp-prompt-optimizer-local

# Check license status
mcp-prompt-optimizer-local check-license

# Show help
mcp-prompt-optimizer-local help

Configuration Options

License Key Sources (Priority Order)

1. Environment Variable: OPTIMIZER_API_KEY
2. User Config File: ~/.mcp_optimizer/config.json
3. Project .env File: .env in current directory

Example Config File

{
  "apiKey": "sk-local-pro-your-key-here",
  "features_enabled": [
    "local_processing",
    "template_management",
    "cross_platform_support",
    "llm_integration"
  ]
}

🔧 Platform-Specific Notes

🍎 macOS

• Security: First run may show security dialog - click "Allow"
• Architectures: Automatic detection of Intel vs Apple Silicon
• Permissions: Installer sets executable permissions automatically

🐧 Linux

• Distributions: Tested on Ubuntu, Debian, CentOS, Fedora, Arch
• ARM64: Full support for Raspberry Pi and ARM servers
• Permissions: Automatic chmod +x during installation

🪟 Windows

• Versions: Windows 10, 11, Server 2019/2022
• Architecture: x64 support with native binary
• Antivirus: May require approval for new binary execution

🚨 Troubleshooting

Installation Issues

# Clear npm cache
npm cache clean --force

# Reinstall package
npm uninstall -g mcp-prompt-optimizer-local
npm install -g mcp-prompt-optimizer-local

# Check platform detection
node -e "console.log('Platform:', process.platform, 'Arch:', process.arch)"

Binary Issues

# Verify security components
npm run verify-security

# Check binary integrity
npm run validate-manifest

# Manual download (if automatic fails)
# Binaries available at: https://github.com/nivlewd1/mcp-prompt-optimizer-local/releases

Permission Issues (macOS/Linux)

# Fix permissions manually
chmod +x ~/.npm-global/lib/node_modules/mcp-prompt-optimizer-local/bin/mcp-optimizer-*

🏢 Enterprise Deployment

Docker Support

FROM node:18-alpine
RUN npm install -g mcp-prompt-optimizer-local
ENV OPTIMIZER_API_KEY="sk-local-pro-your-key-here"
ENV OPENAI_API_KEY="sk-proj-your-openai-key-here"
RUN mcp-prompt-optimizer-local check-license

Kubernetes Deployment

apiVersion: v1
kind: Secret
metadata:
  name: mcp-optimizer-keys
type: Opaque
stringData:
  OPTIMIZER_API_KEY: "sk-local-pro-your-key-here"
  OPENAI_API_KEY: "sk-proj-your-openai-key-here"

CI/CD Integration

- name: Install MCP Optimizer
  run: |
    export OPTIMIZER_API_KEY="${{ secrets.OPTIMIZER_API_KEY }}"
    export OPENAI_API_KEY="${{ secrets.OPENAI_API_KEY }}"
    npm install -g mcp-prompt-optimizer-local
    mcp-prompt-optimizer-local check-license

🔄 Upgrading

npm update -g mcp-prompt-optimizer-local
mcp-prompt-optimizer-local --version

See CHANGELOG.md for breaking changes between versions.

📚 Documentation

• 📖 Full Documentation: https://promptoptimizer.xyz/docs
• 🌍 Cross-Platform Guide: CROSS-PLATFORM.md
• 📝 Changelog: CHANGELOG.md
• 🏗️ Implementation Details: IMPLEMENTATION-SUMMARY.md

🆘 Support

• 🐛 Issues: GitHub Issues
• 📧 Email: [email protected]
• 💬 Discussions: GitHub Discussions

🏆 What's New

See CHANGELOG.md for the full, version-by-version release history.

📊 Technical Specifications

• Node.js: >=16.0.0
• npm: >=8.0.0
• Binary Size: ~15-20MB per platform
• Memory Usage: <100MB typical
• Startup Time: <2 seconds
• Optimization Speed: <500ms per request

Ready to optimize prompts on any platform? Install now and experience the future of cross-platform prompt intelligence! 🚀

🏷️ License

Commercial License - see LICENSE for details.

⭐ Star this repo if you find it useful!

🚀 Install Now • 📖 Documentation • 🌍 Cross-Platform Guide