Serveur de Rétroaction Amélioré MCP (mcp-feedback-enhanced)

Aperçu du Projet

mcp-feedback-enhanced est un serveur MCP (Model Context Protocol) amélioré, spécialement conçu pour la rétroaction interactive des utilisateurs et l'exécution de commandes dans les outils de développement assistés par l'IA. Ce projet prend en charge un mode double interface (interface utilisateur Web et application de bureau), dispose d'une détection intelligente de l'environnement et d'une compatibilité multiplateforme.

Caractéristiques Principales

• Prise en charge double interface: Prend en charge l'interface utilisateur Web et les applications de bureau natives
• Détection intelligente de l'environnement: Détecte automatiquement l'environnement d'exécution et sélectionne le mode d'interface le plus approprié
• Compatibilité multiplateforme: Prend en charge les systèmes Windows, macOS, Linux
• Optimisation des coûts: En guidant l'IA pour qu'elle confirme avec l'utilisateur plutôt que d'effectuer des opérations spéculatives, il est possible de consolider jusqu'à 25 appels d'outils en une seule requête orientée vers la rétroaction, réduisant ainsi considérablement les coûts de la plateforme.

Plateformes Prises en Charge

Les plateformes de développement IA prises en charge incluent : Cursor, Cline, Windsurf

Principe de Fonctionnement

Le flux de travail du projet est le suivant :

1. Appel de l'IA → mcp-feedback-enhanced
2. Détection de l'environnement → Sélection automatique de l'interface appropriée
3. Interaction utilisateur → Exécution de commandes, rétroaction textuelle, téléchargement d'images
4. Transmission de la rétroaction → L'information est renvoyée à l'IA
5. Poursuite du processus → Ajustement ou fin selon la rétroaction

Principales Fonctionnalités

Modes d'Interface

Interface Graphique Qt (GUI)

• Expérience native pour les environnements locaux
• Conception modulaire refactorisée
• Adaptée aux environnements de développement locaux

Interface Utilisateur Web (Web UI)

• Conception d'interface moderne, adaptée aux environnements SSH distants
• Nouvelle conception architecturale
• Disposition réactive, s'adaptant aux différentes tailles d'écran

Fonctions Principales

Fonctionnalités de Traitement d'Images

• Formats pris en charge: PNG, JPG, JPEG, GIF, BMP, WebP
• Méthodes de téléchargement: Glisser-déposer des fichiers + Coller depuis le presse-papiers (Ctrl+V)
• Traitement automatique: Compression intelligente pour garantir le respect de la limite de 1 Mo

Prise en Charge Multilingue

• Trois langues: Anglais, Chinois Traditionnel, Chinois Simplifié
• Détection intelligente: Sélection automatique basée sur la langue du système
• Changement en temps réel: Possibilité de changer la langue directement dans l'interface

Prise en Charge des Raccourcis Clavier

• Ctrl+Entrée: Soumettre la rétroaction (prend en charge le clavier principal et le pavé numérique)
• Ctrl+V: Coller directement l'image du presse-papiers

Installation et Configuration

Installation Rapide

# Installer uv (si ce n'est pas déjà fait)
pip install uv

# Test rapide
uvx mcp-feedback-enhanced@latest test

Configuration de Base

Ajoutez la configuration suivante dans votre assistant IA (par exemple, Cursor) :

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

Configuration Avancée

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

Configuration des Variables d'Environnement

Nom de la variable	Utilisation	Valeur	Valeur par défaut
FORCE_WEB	Force l'utilisation de l'interface utilisateur Web	true/false	false
MCP_DEBUG	Mode débogage	true/false	false
INCLUDE_BASE64_DETAIL	Base64 complète de l'image	true/false	false

Recommandations d'Utilisation

Pour des résultats optimaux, il est recommandé d'ajouter les règles suivantes à votre assistant IA :

# Règles de rétroaction interactive MCP
1. Dans tout processus, tâche ou conversation, qu'il s'agisse de questions, de réponses ou de l'achèvement de tâches intermédiaires, MCP mcp-feedback-enhanced doit être appelé.
2. Lors de la réception d'une rétroaction de l'utilisateur, si le contenu de la rétroaction n'est pas vide, MCP mcp-feedback-enhanced doit être appelé à nouveau et le comportement doit être ajusté en fonction de la rétroaction.
3. Ce n'est que lorsque l'utilisateur indique explicitement "fin" ou "plus d'interaction nécessaire" que l'appel à MCP mcp-feedback-enhanced peut être arrêté, et le processus est alors terminé.
4. Sauf si une commande de fin est reçue, toutes les étapes doivent répéter l'appel à MCP mcp-feedback-enhanced.

Méthodes de Test

Vérification de la Version

uvx mcp-feedback-enhanced@latest version

Tests Spécifiques à l'Interface

# Test rapide de l'interface graphique Qt
uvx mcp-feedback-enhanced@latest test --gui

# Test de l'interface utilisateur Web (exécution continue automatique)
uvx mcp-feedback-enhanced@latest test --web

# Mode débogage
MCP_DEBUG=true uvx mcp-feedback-enhanced@latest test

Tests de Développement Local

# Cloner le projet
git clone https://github.com/Minidoracat/mcp-feedback-enhanced.git
cd mcp-feedback-enhanced
uv sync

# Méthode 1 : Test standard (recommandé)
uv run python -m mcp_feedback_enhanced test

# Méthode 2 : Suite de tests complète
uvx --with-editable . mcp-feedback-enhanced test

# Méthode 3 : Tests spécifiques à l'interface
uvx --with-editable . mcp-feedback-enhanced test --gui  # Test de l'interface graphique Qt
uvx --with-editable . mcp-feedback-enhanced test --web  # Test de l'interface utilisateur Web

Historique des Versions et Mises à Jour Majeures

Dernières Fonctionnalités (v2.6.0 et supérieur)

• Refonte complète: L'interface graphique et l'interface utilisateur Web adoptent une architecture modulaire
• Gestion centralisée: Restructuration de l'arborescence des dossiers pour une meilleure maintenabilité
• Optimisation de l'interface: Conception modernisée et expérience utilisateur améliorée
• Optimisation de l'interface macOS: Améliorations spécifiques pour l'expérience utilisateur macOS
• Amélioration des fonctionnalités: Nouvelles options de réglage et fonction de fermeture automatique de la page

Améliorations Clés

• Changement de langue: Correction du problème de mise à jour du contenu lors du changement de langue dans l'interface utilisateur Web
• Page "À propos": Ajout d'une page "À propos" contenant les informations de version, les liens du projet et les remerciements
• Raccourcis clavier améliorés: Ctrl+Entrée prend en charge le pavé numérique
• Collage intelligent d'images: Ctrl+V colle directement l'image du presse-papiers
• Refonte de l'architecture multilingue: Chargement dynamique et organisation modulaire des fichiers de langue

Foire Aux Questions (FAQ)

Q: Erreur "Unexpected token 'D'"

R: Interférence de la sortie de débogage. Définissez MCP_DEBUG=false ou supprimez la variable d'environnement.

Q: Caractères chinois corrompus

R: Corrigé dans la version v2.0.3. Mettez à jour vers la dernière version : uvx mcp-feedback-enhanced@latest

Q: Échec du téléchargement d'images

R: Vérifiez la taille du fichier (≤1 Mo) et le format (PNG/JPG/GIF/BMP/WebP).

Q: L'interface utilisateur Web ne démarre pas

R: Définissez FORCE_WEB=true ou vérifiez les paramètres du pare-feu.

Q: Gemini Pro 2.5 ne peut pas analyser les images

R: Problème connu. Gemini Pro 2.5 peut ne pas analyser correctement le contenu des images téléchargées. Les tests montrent que Claude-4-Sonnet peut analyser correctement les images. Il est recommandé d'utiliser le modèle Claude pour une meilleure compréhension des images.

Valeur du Projet

La valeur fondamentale de ce projet réside dans la résolution d'un problème clé du développement assisté par l'IA : éviter que l'IA n'effectue des opérations spéculatives coûteuses. En établissant une boucle de rétroaction interactive homme-machine, les utilisateurs peuvent fournir une confirmation et des conseils avant que l'IA n'exécute des opérations complexes ou coûteuses, ce qui permet de :

1. Réduire les coûts: Diminuer les appels API inutiles
2. Améliorer l'efficacité: Éviter les chemins d'opération erronés
3. Renforcer le contrôle: L'utilisateur conserve la maîtrise du processus de développement
4. Améliorer l'expérience: Un flux de travail de développement collaboratif homme-machine plus fluide