Servidor de Feedback Aprimorado MCP (mcp-feedback-enhanced)

Visão Geral do Projeto

mcp-feedback-enhanced é um servidor MCP (Model Context Protocol) aprimorado, projetado especificamente para feedback interativo do usuário e execução de comandos em ferramentas de desenvolvimento assistidas por IA. Este projeto suporta modo de interface dupla (Web UI e aplicativo de desktop), com detecção inteligente de ambiente e compatibilidade multiplataforma.

Características Principais

• Suporte a Interface Dupla: Suporta Web UI e aplicativos de desktop nativos
• Detecção Inteligente de Ambiente: Detecta automaticamente o ambiente de execução e seleciona o modo de interface mais adequado
• Compatibilidade Multiplataforma: Suporta sistemas Windows, macOS e Linux
• Otimização de Custos: Ao guiar a IA para confirmar com o usuário em vez de realizar operações especulativas, pode consolidar até 25 chamadas de ferramentas em uma única solicitação orientada a feedback, reduzindo significativamente os custos da plataforma

Plataformas Suportadas

As plataformas de desenvolvimento de IA suportadas incluem: Cursor, Cline, Windsurf

Como Funciona

O fluxo de trabalho do projeto é o seguinte:

1. Chamada da IA → mcp-feedback-enhanced
2. Detecção de Ambiente → Seleção automática da interface apropriada
3. Interação do Usuário → Execução de comandos, feedback de texto, upload de imagens
4. Entrega de Feedback → Informações retornadas à IA
5. Continuação do Processo → Ajuste ou conclusão com base no feedback

Principais Recursos e Funcionalidades

Modos de Interface

Interface Qt GUI

• Experiência nativa em ambiente local
• Design modular e reestruturado
• Adequado para ambientes de desenvolvimento local

Interface Web UI

• Design de interface moderno, adequado para ambientes SSH remotos
• Novo design de arquitetura
• Layout responsivo, adaptável a diferentes tamanhos de tela

Funções Principais

Funcionalidades de Processamento de Imagem

• Formatos Suportados: PNG, JPG, JPEG, GIF, BMP, WebP
• Métodos de Upload: Arrastar e soltar arquivos + colar da área de transferência (Ctrl+V)
• Processamento Automático: Compressão inteligente para garantir conformidade com o limite de 1MB

Suporte a Múltiplos Idiomas

• Três Idiomas: Inglês, Chinês Tradicional, Chinês Simplificado
• Detecção Inteligente: Seleção automática com base no idioma do sistema
• Troca em Tempo Real: Altere o idioma diretamente na interface

Suporte a Atalhos de Teclado

• Ctrl+Enter: Enviar feedback (suporta teclado principal e teclado numérico)
• Ctrl+V: Colar diretamente a imagem da área de transferência

Instalação e Configuração

Instalação Rápida

# Instalar uv (se ainda não estiver instalado)
pip install uv

# Teste rápido
uvx mcp-feedback-enhanced@latest test

Configuração Básica

Adicione a seguinte configuração ao seu assistente de IA (como Cursor):

{
  "mcpServers": {
    "mcp-feedback-enhanced": {
      "command": "uvx",
      "args": ["mcp-feedback-enhanced@latest"],
      "timeout": 600,
      "autoApprove": ["interactive_feedback"]
    }
  }
}

Configuração Avançada

{
  "mcpServers": {
    "mcp-feedback-enhanced": {
      "command": "uvx",
      "args": ["mcp-feedback-enhanced@latest"],
      "timeout": 600,
      "env": {
        "FORCE_WEB": "true",
        "MCP_DEBUG": "false"
      },
      "autoApprove": ["interactive_feedback"]
    }
  }
}

Configuração de Variáveis de Ambiente

Variável	Propósito	Valores	Valor Padrão
FORCE_WEB	Forçar uso da Web UI	true/false	false
MCP_DEBUG	Modo de depuração	true/false	false
INCLUDE_BASE64_DETAIL	Base64 completo da imagem	true/false	false

Sugestões de Uso

Para obter os melhores resultados, é recomendável adicionar as seguintes regras ao seu assistente de IA:

# Regras de Feedback Interativo MCP
1. Em qualquer processo, tarefa ou conversa, seja para perguntar, responder ou concluir tarefas de fase, o MCP mcp-feedback-enhanced deve ser chamado.
2. Ao receber feedback do usuário, se o conteúdo do feedback não estiver vazio, o MCP mcp-feedback-enhanced deve ser chamado novamente e o comportamento ajustado de acordo com o feedback.
3. Somente quando o usuário indicar explicitamente "fim" ou "não precisa de mais interação", a chamada ao MCP mcp-feedback-enhanced pode ser interrompida, e então o processo é concluído.
4. A menos que um comando de término seja recebido, todas as etapas devem chamar repetidamente o MCP mcp-feedback-enhanced.

Métodos de Teste

Verificação de Versão

uvx mcp-feedback-enhanced@latest version

Teste Específico da Interface

# Teste rápido da Qt GUI
uvx mcp-feedback-enhanced@latest test --gui

# Teste da Web UI (execução contínua automática)
uvx mcp-feedback-enhanced@latest test --web

# Modo de depuração
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test

Teste de Desenvolvimento Local

# Clonar o projeto
git clone https://github.com/Minidoracat/mcp-feedback-enhanced.git
cd mcp-feedback-enhanced
uv sync

# Método 1: Teste padrão (recomendado)
uv run python -m mcp_feedback_enhanced test

# Método 2: Suíte de teste completa
uvx --with-editable . mcp-feedback-enhanced test

# Método 3: Teste específico da interface
uvx --with-editable . mcp-feedback-enhanced test --gui  # Teste da Qt GUI
uvx --with-editable . mcp-feedback-enhanced test --web  # Teste da Web UI

Histórico de Versões e Principais Atualizações

Últimos Recursos (v2.6.0 e superior)

• Reestruturação Completa: GUI e Web UI adotam arquitetura modular
• Gerenciamento Centralizado: Reorganização da estrutura de pastas para melhorar a manutenibilidade
• Otimização da Interface: Design moderno e experiência do usuário aprimorada
• Otimização da Interface macOS: Melhorias específicas para a experiência do usuário macOS
• Funcionalidades Aprimoradas: Novas opções de configuração e função de fechamento automático de página

Melhorias Principais

• Troca de Idioma: Correção do problema de atualização de conteúdo ao trocar de idioma na Web UI
• Página "Sobre": Adição de uma página "Sobre" contendo informações de versão, links do projeto e agradecimentos
• Atalhos Aprimorados: Ctrl+Enter suporta teclado numérico
• Colagem Inteligente de Imagens: Ctrl+V cola diretamente imagens da área de transferência
• Reestruturação da Arquitetura Multilíngue: Carregamento dinâmico e organização modular de arquivos de idioma

Perguntas Frequentes

P: Ocorre o erro "Unexpected token 'D'"

R: A saída de depuração está interferindo. Defina MCP_DEBUG=false ou remova a variável de ambiente.

P: Caracteres chineses aparecem corrompidos

R: Corrigido na versão v2.0.3. Atualize para a versão mais recente: uvx mcp-feedback-enhanced@latest

P: Falha no upload de imagens

R: Verifique o tamanho do arquivo (≤1MB) e o formato (PNG/JPG/GIF/BMP/WebP).

P: A Web UI não inicia

R: Defina FORCE_WEB=true ou verifique as configurações do firewall.

P: Gemini Pro 2.5 não consegue analisar imagens

R: Problema conhecido. O Gemini Pro 2.5 pode não conseguir analisar corretamente o conteúdo das imagens carregadas. Testes mostram que o Claude-4-Sonnet pode analisar imagens corretamente. Recomenda-se usar o modelo Claude para uma melhor capacidade de compreensão de imagens.

Valor do Projeto

O valor central deste projeto reside em resolver um problema crucial no desenvolvimento assistido por IA: evitar que a IA realize operações especulativas caras. Ao estabelecer um ciclo de feedback de interação humano-máquina, os usuários podem fornecer confirmação e orientação antes que a IA execute operações complexas ou de alto custo, o que resulta em:

1. Redução de Custos: Diminuição de chamadas de API desnecessárias
2. Aumento da Eficiência: Evita caminhos de operação errôneos
3. Controle Aprimorado: O usuário mantém o controle sobre o processo de desenvolvimento
4. Melhora da Experiência: Um fluxo de trabalho de desenvolvimento colaborativo humano-máquina mais fluido