jadenmaciel/ai-validation-mcp-server

🚀 AI Validation MCP Server - Automatic Prompt Optimization

A fully automatic prompt optimization Model Context Protocol (MCP) server that enhances every prompt with world-class prompt engineering techniques. No manual intervention required - just install, configure, and every prompt gets automatically optimized!

✨ What It Does

🎯 Fully Automatic: Every prompt you send gets automatically enhanced with expert techniques
🧠 Expert-Level Optimization: Applies world-class prompt engineering without any manual work
🔍 Visual Feedback: Shows exactly what optimizations were applied to each prompt
⚡ Smart Detection: Automatically detects technical, creative, or analytical content
🎨 Domain Expertise: Adds appropriate expert context based on your prompt content

🎯 Example: Before vs After

Your Original Prompt:

Use the auto_optimize tool with prompt: "How do I write better Python code?"

What You'll See (Automatically Enhanced):

🚀 **AI VALIDATION: PROMPT AUTOMATICALLY OPTIMIZED** 🚀

🔧 **ORIGINAL PROMPT**: How do I write better Python code?

✨ **AUTO-OPTIMIZED VERSION**: Please provide a comprehensive and detailed response with specific examples and practical guidance.

As a senior technical expert, please include best practices, potential pitfalls, and real-world implementation considerations.

Please explain your reasoning and methodology.

🔍 **OPTIMIZATIONS APPLIED**:
  • 🎯 Enhanced clarity and detail requirements
  • 🛠️ Technical expertise context added  
  • 🧠 Reasoning and methodology requested
  • 🌟 Expert system identity applied

---

[Then you get a comprehensive expert response with examples, best practices, step-by-step guidance, etc.]

🚀 Quick Start

Step 1: Install

# Clone the repository
git clone https://github.com/jadenmaciel/ai-validation-mcp-server.git
cd ai-validation-mcp-server

# Set up virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Step 2: Configure Cursor

Add this to your ~/.cursor/mcp.json file:

{
  "mcpServers": {
    "ai_validation_auto": {
      "command": "python3",
      "args": ["/path/to/ai-validation-mcp-server/run_mcp_auto.py"]
    }
  }
}

Important: Replace /path/to/ai-validation-mcp-server/ with your actual path!

Step 3: Restart Cursor

1. Close all Cursor windows
2. Quit Cursor entirely (Cmd+Q / Ctrl+Q)
3. Restart Cursor

Step 4: Verify It's Working

1. Go to Settings → Features → MCP Servers
2. Look for ai_validation_auto with a green dot ✅
3. Try asking any question - you should see the optimization indicators!

🎯 Automatic Optimizations Applied

The server automatically detects your prompt type and applies appropriate enhancements:

🛠️ Technical Prompts (code, programming, technical questions)

• Adds senior technical expert context
• Requests best practices and pitfalls
• Asks for implementation considerations

🎨 Creative Prompts (writing, design, creative tasks)

• Adds creative professional context
• Requests innovative approaches and options
• Asks for creative insights

📊 Analytical Prompts (data, research, analysis)

• Adds analytical expert context
• Requests systematic analysis
• Asks for data-driven insights

🎯 All Prompts Get:

• Enhanced clarity and detail requirements
• Structured response formatting (when appropriate)
• Concrete examples and illustrations
• Step-by-step explanations for complex topics
• Expert-level system identity

📁 Project Structure

ai-validation-mcp-server/
├── ai_validation_mcp_auto.py    # 🚀 Main automatic optimization server
├── run_mcp_auto.py              # 🔧 Server runner with venv handling
├── requirements.txt             # 📦 Python dependencies
├── README.md                    # 📖 This documentation
├── LICENSE                      # ⚖️ MIT License
├── .gitignore                   # 🙈 Git ignore rules
└── venv/                        # 🐍 Virtual environment (auto-created)

🔧 Configuration Options

The server works automatically with zero configuration, but you can customize by editing ai_validation_mcp_auto.py:

• Modify optimization rules in optimize_user_prompt()
• Adjust expert system prompt in create_expert_system_prompt()
• Change detection patterns for different prompt types

🔍 Troubleshooting

Green dot not showing?

Step 1: Ensure MCP Server is Set Up Go to your MCP server folder:

cd /home/jaden/ai-validation-server

Activate its virtual environment:

source venv/bin/activate

Start the MCP server manually to confirm it runs without error:

python ai_validation_mcp_auto.py

You should see the startup message similar to:

🚀 Starting AI Validation MCP Server (Automatic Mode)
Press Ctrl+C to stop the server.

No optimization indicators?

1. Verify the green dot is present in MCP settings
2. Check absolute path in mcp.json is correct
3. Ensure Cursor was completely restarted (not just closed)

Permissions issues?

chmod +x /path/to/ai-validation-mcp-server/run_mcp_auto.py
chmod +x /path/to/ai-validation-mcp-server/ai_validation_mcp_auto.py

Check logs:

• In Cursor: Ctrl+Shift+U → "MCP Logs"
• Look for "🚀 Starting AI Validation MCP Server (Automatic Mode)"

🎉 What You Get

✅ Zero Manual Work - Every prompt automatically optimized
✅ Expert-Level Responses - World-class prompt engineering applied
✅ Visual Confirmation - See exactly what optimizations were applied
✅ Smart Detection - Appropriate expertise based on content
✅ Better Results - More comprehensive, structured, actionable responses

🤝 Contributing

Contributions welcome! Feel free to:

• Improve optimization techniques
• Add new prompt detection patterns
• Enhance the expert system prompts
• Submit bug reports or feature requests

📄 License

MIT License - see file for details.

Transform every prompt into an expertly optimized query automatically! 🚀

Repository: https://github.com/jadenmaciel/ai-validation-mcp-server