MCP 服务器

PromptEngine-AI MCP

Enables prompt evaluation and refactoring via MCP protocol, allowing clients like OpenWebUI, Claude Desktop, and Cursor to access the Eliezer prompt engineer's 5-dimension scoring, ambiguity detection, and XML prompt generation.

README

<h1 align="center">🤖 PromptEngine.AI — Eliezer TUI</h1> Engine de Engenharia de Prompt & Orquestração de Agentes com Persona Irônica (TUI / MCP / Ollama / Gemini) Uma ferramenta de elite para avaliar a qualidade de instruções de entrada, eliminar ambiguidades e refatorar prompts para agentes autônomos em tempo real.

Navegação Rápida: <a href="#-visão-geral-do-projeto">🎯 Visão Geral</a> • <a href="#-persona-eliezer">🎭 Persona Eliezer</a> • <a href="#-arquitetura-do-sistema">🏛️ Arquitetura</a> • <a href="#-funcionalidades-principais">⚡ Funcionalidades</a> • <a href="#-guia-de-instalação--execução">⚙️ Guia de Execução</a> • <a href="#-licença--governança">🛡️ Licença</a>

[!WARNING] VERSÃO EM DESENVOLVIMENTO (WORK IN PROGRESS - BETA v0.9.0): Este projeto não é uma versão final estática. Ele está em constante evolução no repositório de portfólio para incorporar novos aprendizados, refinamento de metaprompts e novos conectores MCP.

🎯 Visão Geral do Projeto

<table align="center"> <tr> <td width="30%" align="center"> <h2>🤖 ELIEZER</h2> Prompt Engineer Agent Sarcástico, Irônico & Ultra-Técnico </td> <td width="70%"> PromptEngine.AI é um agente orquestrador projetado para atuar como um filtro de qualidade de comandos antes que ordens brutas sejam disparadas para agentes de software autônomos ou subagentes. Ele analisa instruções em 5 dimensões críticas (Clareza, Especificidade, Contexto, Restrições e Actionability), detecta ambiguidades e gera a versão refatorada do prompt em formato XML/Markdown pronto para uso. </td> </tr> </table>

[!NOTE] Metáfora Operacional: Pense no PromptEngine.AI como o "Revisor Mestre de Instruções". Ele impede que ordens vagas gerem respostas de baixa qualidade, economizando tempo e consumo desnecessário de tokens.

🎭 Persona Eliezer

O agente adota a persona Eliezer:

Tom de Comunicação: Sarcástico, pragmático e sem paciência para prompts medíocres ou sem contexto.
Diálogo e Esclarecimentos: Utiliza comentários irônicos e emojis no terminal para pontuar falhas de especificidade do usuário.
Saída Otimizada (Clean Output): O prompt refatorado final é entregue 100% limpo, sem emojis e sem ironias, no formato XML/Markdown estrito pronto para cópia em produção.

🏛️ Arquitetura do Sistema

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              PROMPTENGINE.AI ARCHITECTURE                              │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                        │
│  [Usuário / Input] ──► [Eliezer TUI (Textual + Rich)] ──► [PromptEvaluator Engine]    │
│                            (Tela Cheia / Terminal)            (Avaliação 5D Pydantic)  │
│                                                                        │               │
│                                                                        ▼               │
│  [Servidor MCP Protocol] ◄──────────────────────────────── [LLM Provider Abstraction] │
│  (Ferramentas OpenWebUI)                                    (Google GenAI / Ollama)    │
│                                                                        │               │
│                                                                        ▼               │
│                                                            [DeepSeek-R1 8B (Disco D)]  │
│                                                            (NVIDIA RTX 3060 Ti VRAM)   │
└────────────────────────────────────────────────────────────────────────────────────────┘

⚡ Funcionalidades Principais

Ícone & Recurso	Descrição Técnica
📊 Scorecard de 5 Dimensões	Avalia Clareza, Especificidade, Contexto, Restrições e Actionability (0 a 10) com barras visuais em Rich.
⚠️ Detecção de Ambiguidades	Mapeia termos vagos, premissas implícitas e lacunas na instrução do usuário.
❓ Perguntas de Alinhamento	Gera perguntas estratégicas para sanar dúvidas antes do acionamento do agente destino.
✨ Refatorador de Prompt XML	Gera a versão final da ordem estruturada em tags `<contexto>`, `<instrucao>`, `<restricoes>` e `<formato_saida>`.
💻 TUI Interativa em Tela Cheia	Interface construída com `textual` e `rich` com suporte a teclado, formulários e temas escuros.
🔌 Servidor MCP Protocol	Exposição nativa de ferramentas JSON-RPC para OpenWebUI, Claude Desktop e Cursor.
🏠 Raciocínio Local (Ollama + Disco D)	Suporte nativo ao modelo DeepSeek-R1 8B rodando na GPU (NVIDIA RTX 3060 Ti) armazenado no SSD `D:\OllamaModels`.

🧭 Estrutura do Repositório

prompt-eval-agent/
├── LICENSE                      # Licença Open-Source MIT
├── PRD.md                       # Product Requirement Document
├── SDD.md                       # Software Design Document
├── README.md                    # Este arquivo
├── rodar_agente.bat             # Atalho de duplo clique no Windows
├── requirements.txt             # Dependências Python (textual, rich, google-genai, mcp)
└── src/
    ├── main.py                  # Entrypoint principal (Lança a TUI Eliezer)
    ├── main_cli.py              # CLI legado (Modo terminal simples)
    ├── mcp_server.py            # Servidor de ferramentas MCP Protocol
    ├── engine/
    │   ├── evaluator.py         # Motor central de avaliação
    │   ├── models.py            # Esquemas Pydantic
    │   └── prompt_templates.py  # Metaprompts da persona Eliezer
    ├── providers/
    │   ├── base.py              # Interface abstrata de LLM
    │   ├── google_provider.py   # Provedor Google GenAI SDK (Gemini 2.5 Flash)
    │   └── ollama_provider.py   # Provedor Ollama Local (DeepSeek R1 8B)
    └── ui/
        ├── __init__.py
        └── tui_app.py           # Aplicação TUI em Textual + Rich

⚙️ Guia de Instalação & Execução

1. Clonar e Acessar o Repositório

git clone https://github.com/SEU_USUARIO/PromptEngine-AI.git
cd PromptEngine-AI

2. Configurar o Ambiente Virtual Python

python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt

3. Executar o Agente

🖱️ Opção A (Windows — 2 Clicks):

Basta dar duplo clique no arquivo rodar_agente.bat.

💻 Opção B (Linha de Comando TUI):

python -m src.main --provider ollama --model deepseek-r1:8b

🔌 Opção C (Servidor MCP para OpenWebUI / Claude):

python -m src.mcp_server

🛡️ Licença & Governança

Este projeto é disponibilizado sob a licença MIT License.

Autor: Kalyel N. Laurindo | Software Engineer & AI Builder Projeto desenvolvido para o Portfólio de IA & Engenharia de Prompt