AI Validation MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/jadenmaciel/ai-validation-mcp-server.git
cd ai-validation-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add ai-validation-mcp -- python3 "<FULL_PATH_TO_AI_VALIDATION_MCP_SERVER>/dist/index.js"

Replace <FULL_PATH_TO_AI_VALIDATION_MCP_SERVER>/dist/index.js with the actual folder you prepared in step 1.

README.md

Fully automatic prompt optimization for expert-level AI responses

šŸš€ 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

Configuration

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

Try it

→How do I write better Python code?
→Write a short story about a futuristic city.
→Analyze the current trends in renewable energy.
→Explain how to optimize a SQL query.

Frequently Asked Questions

What are the key features of AI Validation MCP Server?

Fully automatic prompt enhancement using expert engineering techniques. Visual feedback showing exactly what optimizations were applied. Automatic detection of technical, creative, or analytical content. Domain-specific context injection for higher quality responses.

What can I use AI Validation MCP Server for?

Improving the quality of technical coding questions for better implementation guidance. Enhancing creative writing prompts to elicit more innovative and detailed responses. Structuring analytical queries to ensure systematic data-driven insights. Standardizing prompt quality across different AI interaction sessions.

How do I install AI Validation MCP Server?

Install AI Validation MCP Server by running: git clone https://github.com/jadenmaciel/ai-validation-mcp-server.git && cd ai-validation-mcp-server && python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt

What MCP clients work with AI Validation MCP Server?

AI Validation MCP Server works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep AI Validation MCP Server docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare