Skip to main content
Glama

@imenam/mcp-feature-analyzer

Une table de relecture pour le code écrit par un agent IA, avec une interface graphique où un humain relit, trie et tranche.

L'agent qui vient de développer une feature ouvre une analyse : le serveur fige le diff git, l'agent y ajoute un résumé, des constats classés par gravité et des schémas. L'utilisateur relit le tout dans la GUI, fichier par fichier, ignore ce qui ne compte pas, annote, puis enregistre une décision. L'agent relit ensuite exactement ce qui a été retenu, sous la forme d'un prompt de correction prêt à suivre.

Agent ──create_analysis / add_findings / set_diagram──▶  Analyse  ◀──relecture, remarques──  Utilisateur (GUI)
  ▲                                                                                              │
  └──────────── get_review_feedback ──── décision, points retenus, prompt ◀── « Enregistrer le retour »

Le serveur n'appelle aucun LLM et n'écrit jamais dans le dépôt : il lit git, conserve l'analyse, et affiche.


Installation

npm install -g @imenam/mcp-feature-analyzer

Ou directement via npx, sans installation. Le serveur communique en JSON-RPC sur stdio : il est lancé par le client MCP (Claude Code, par exemple), pas à la main. Par défaut, il tourne sur la machine qui héberge le dépôt et y exécute git lui-même ; derrière un gateway, sur une autre machine, voir Derrière mcp-http-gateway.

Déclaration dans un projet

Depuis la racine du projet :

npx -y @imenam/mcp-feature-analyzer --claude-setup-mcp

La commande crée (ou complète) le .mcp.json du répertoire courant avec une entrée mcp-feature-analyzer dont les variables sont pré-remplies. Ajoutez --force pour remplacer une entrée existante ; les autres serveurs sont préservés. Un .mcp.json illisible fait échouer la commande, sans rien écrire.

Deux flags choisissent directement comment la GUI sera exposée :

# GUI derrière le proxy central
npx -y @imenam/mcp-feature-analyzer --claude-setup-mcp --proxy_url=http://localhost:3000

# GUI en accès direct, sans proxy : http://localhost:4600
npx -y @imenam/mcp-feature-analyzer --claude-setup-mcp --app_port=4600

Les deux flags sont exclusifs : la commande échoue si les deux sont passés. Sans l'un ni l'autre, PROXY_URL reçoit le modèle http://localhost: dont il reste à compléter le port.

Exemple d'entrée générée dans C:/dev/mon-projet avec --proxy_url=http://localhost:3000 :

{
  "mcpServers": {
    "mcp-feature-analyzer": {
      "command": "npx",
      "args": ["-y", "@imenam/mcp-feature-analyzer"],
      "env": {
        "PROXY_URL": "http://localhost:3000",
        "APP_PORT": "",
        "APP_GROUP": "Mon-projet",
        "APP_NAME": "Feature Analyzer Mon Projet",
        "APP_PATH": "/feature-analyzer-mon-projet",
        "DATA_DIR": "C:/dev/mon-projet/.feature-analyzer-data",
        "MCP_LOG_DIR": ""
      }
    }
  }
}

Une variable laissée vide est inactive.

Variables d'environnement

Elles se renseignent dans le champ env de .mcp.json, ou dans un fichier .env à la racine du package, qui prime et est relu à chaque relance de la GUI.

Variable

Rôle

PROXY_URL

URL du proxy central : le proxy attribue le port et monte la GUI sous APP_PATH. Prime sur APP_PORT.

APP_PORT

Port local utilisé quand PROXY_URL est absent : la GUI est servie directement sur http://localhost:<port>, à la racine.

APP_PATH

Chemin de montage de la GUI derrière le proxy (défaut /feature-analyzer). Ignoré en mode APP_PORT.

APP_PATH_PREFIX

Préfixe de namespace appliqué au chemin par le client proxy partagé ; le <base href> de la GUI suit le chemin réellement enregistré.

APP_NAME

Nom affiché dans le dashboard du proxy (défaut Feature Analyzer).

APP_GROUP

Section repliable du dashboard du proxy (facultatif).

DATA_DIR

Obligatoire, sans défaut : répertoire de stockage des analyses, créé s'il n'existe pas. Le serveur refuse de démarrer sans lui. Le MCP Gateway Manager le renseigne automatiquement.

MCP_LOG_DIR

Répertoire des logs. Défaut : <DATA_DIR>/logs.

MCP_FEATURE_ANALYZER_ROLE

standalone (défaut) : git s'exécute sur la machine du serveur. remote : le serveur est derrière mcp-http-gateway et fait exécuter git sur la machine de l'agent. Une autre valeur fait refuser le démarrage. Lu au démarrage.

PROXY_URL et APP_PORT s'excluent : PROXY_URL prime si les deux sont renseignés. Si aucune des deux n'est définie, la GUI est désactivée ; les outils MCP continuent de fonctionner. Un APP_PORT qui n'est pas un entier entre 1 et 65535 désactive aussi la GUI : le worker s'arrête en écrivant la raison sur sa sortie d'erreur.

Derrière mcp-http-gateway

Placé dans un gateway (mcp-http-gateway, éventuellement piloté par le gateway manager), le serveur tourne sur la machine du gateway et n'y trouve pas les dépôts de l'agent. En rôle remote, create_analysis et refresh_analysis font exécuter git et la lecture des fichiers sur la machine de l'agent, par son relais mcp-http-gateway --mcp (convention _gateway_exec). Le snapshot figé est ensuite conservé côté gateway, et les autres outils comme la GUI n'ont plus besoin du dépôt.

Côté gateway, dans le bloc env du serveur :

{
  "MCP_SERVER_ROUTE": "/feature-analyzer",
  "MCP_FEATURE_ANALYZER_ROLE": "remote"
}

Côté agent, la route doit figurer dans la liste blanche d'exécution du relais :

{
  "mcpServers": {
    "gateway": {
      "command": "npx",
      "args": ["-y", "@imenam/mcp-http-gateway", "--mcp"],
      "env": {
        "GATEWAY_URL": "https://gateway.example.com",
        "GATEWAY_TOKEN": "…",
        "GATEWAY_EXEC_ROUTES": "/feature-analyzer"
      }
    }
  }
}
  • repo_path est le chemin absolu de la racine du dépôt sur la machine de l'agent. git et node doivent y être dans le PATH : node lit les fichiers de la copie de travail.

  • Sans GATEWAY_EXEC_ROUTES, create_analysis et refresh_analysis échouent en indiquant la route à ajouter ; aucun git n'est lancé côté gateway.

  • Le relais limite la sortie de chaque commande à 1 Mio. Le diff est donc demandé fichier par fichier :

    • le diff d'un seul fichier qui dépasse 1 Mio fait échouer l'analyse, avec le nom du fichier ;

    • un fichier modifié de plus de 1 Mio est conservé sans contenu, comme en local ;

    • un fichier non suivi de plus de 1 Mio fait échouer l'analyse en mode working_tree.

  • Les commandes sont envoyées au relais par paquets de 25. Le relais accepte 50 allers-retours par appel d'outil, soit environ 550 fichiers modifiés par analyse.

  • L'endpoint natif /mcp du gateway n'a pas de relais agent : create_analysis et refresh_analysis n'y fonctionnent pas en rôle remote.


Related MCP server: Pingfusi

Les outils

Quatorze outils. Les noms, descriptions et textes de résultat sont en anglais ; chaque résultat de modification se termine par le lien vers l'analyse dans la GUI (Open the review: <url>#/<id>) quand la GUI est active.

Analyses

Outil

Effet

list_analyses

Point d'entrée : les 5 analyses les plus récemment modifiées (limit change ce nombre ; la réponse signale quand la liste est tronquée), regroupées par projet, chacune avec ses refs, ses constats ouverts par gravité, ses fichiers revus, son nombre de schémas et l'état de sa revue ; une revue soumise est « pending processing » tant que l'agent ne l'a pas marquée traitée, « processed at … » ensuite, avec la note du traitement ; une revue approuvée est « nothing to process ». project limite la liste à un projet (un nom inconnu liste les projets existants) ; review_state à un état de revue (not_started, in_progress, files_reviewed, submitted), aux revues soumises restant à traiter (to_process) ou qui n'attendent plus l'agent (processed : marquées traitées, ou approuvées). Invite l'agent à reprendre l'analyse existante d'une feature plutôt qu'à en créer une autre. Signale aussi les fichiers d'analyse illisibles.

create_analysis

Calcule et fige le diff : repo_path (racine absolue du dépôt), project (projet ou feature, dossier de rangement, requis), title, mode (branch ou working_tree), base (requis en branch), head (en branch, défaut HEAD), request_text et request_source (la demande initiale : ticket, prompt), follow_up_of (voir Revues de suivi). Renvoie l'identifiant et la liste des fichiers.

get_analysis

Vue complète : projet, demande, vue d'ensemble, résumé, fichiers (revus ou non), constats avec statut et emplacement, remarques du relecteur, schémas (signalés quand leur tracé a des croisements), état de la revue, et ses liens de suivi (analyse suivie avec le rang du tour, revue de suivi avec son état).

update_analysis

Change title, project, la vue d'ensemble (objective, approach, attention_points), summary (les changements fonctionnels de la feature, une puce par changement, remplace toute la liste) ou la demande initiale (request_text, request_source ; null efface). Les champs absents sont conservés.

refresh_analysis

Recalcule le diff avec le même dépôt, le même mode et les mêmes refs, après correction. Voir Les deux modes de diff.

delete_analysis

Supprime l'analyse et son diff figé. Le dépôt n'est pas touché. Supprime aussi une analyse listée comme illisible. Sa revue de suivi, si elle en a une, est conservée et devient une première revue.

La vue d'ensemble est l'analyse globale de l'agent : l'objectif fonctionnel de la feature, l'approche retenue (architecture, flux principal) et les points d'attention à vérifier en priorité. Sans vue d'ensemble, objective et approach sont requis ensemble pour la créer (attention_points vaut alors une liste vide s'il est omis) ; ensuite, chaque champ donné remplace le précédent. objective: null retire toute la vue d'ensemble. L'objectif figure aussi en tête du prompt de retour.

L'état de revue est dérivé des fichiers revus et de la soumission (shared/review-state.ts) : not_started (aucun fichier revu), in_progress (au moins un), files_reviewed (tous, revue non soumise), submitted (avec sa décision et son traitement par l'agent).

Diff

Outil

Effet

get_diff

Diff figé d'un fichier (path) ou de tous, avec pour chaque ligne son numéro ancien et son numéro nouveau. Les constats, remarques et nœuds s'ancrent toujours sur les numéros du côté nouveau (deuxième colonne).

Constats

Outil

Effet

add_findings

Ajoute un lot de constats. Chacun a une gravité (critical, major, minor, trivial), une nature (issue par défaut, ou requirement_gap pour un comportement demandé mais absent), un titre, un corps, et selon le cas path + start_line (+ end_line), une suggestion (texte de remplacement des lignes visées, conservé tel quel) et un prompt propre. Les lignes visées sont copiées du diff figé. Un seul constat invalide et rien n'est ajouté ; toutes les erreurs sont listées.

update_finding

Modifie les champs d'un constat. Un nouvel emplacement est vérifié contre le diff et rouvre un constat obsolète ; path: null retire l'emplacement (requirement_gap seulement). Le statut « ignoré » appartient au relecteur et ne se change pas ici.

delete_findings

Supprime des constats par identifiant, avec les remarques du relecteur posées depuis leur carte, et les retire de la sélection de la revue. Un identifiant inconnu fait échouer l'appel sans rien supprimer.

Un issue a toujours un emplacement ; un requirement_gap peut ne pas en avoir. Une suggestion n'est jamais appliquée : la GUI l'affiche (lignes actuelles barrées, lignes proposées) et le prompt la transmet.

Explications

Une explication décrit ce que fait un bloc de code ajouté ou supprimé, et comment il le fait. Elle aide le relecteur à comprendre le code avant de le juger : ce n'est pas un constat, elle ne demande rien et n'entre pas dans le retour de revue. Les instructions du serveur demandent à l'agent d'en écrire une pour chaque bloc long (une trentaine de lignes ou plus) ou complexe (algorithme, machine à états, concurrence, expression régulière délicate…), et jamais pour du code trivial.

Outil

Effet

add_explanations

Ajoute un lot d'explications : titre, corps, path + start_line (+ end_line) et side. side: "new" (par défaut) vise du code ajouté ou conservé, en numéros du côté nouveau ; side: "old" vise du code supprimé, en numéros du côté ancien (première colonne de get_diff), lignes toutes présentes dans le diff et dont au moins une est supprimée. Les lignes décrites sont copiées du diff figé. Une seule explication invalide et rien n'est ajouté.

update_explanation

Modifie le titre, le corps ou l'emplacement d'une explication. Un nouvel emplacement est vérifié contre le diff et rend son statut « à jour » à une explication obsolète.

delete_explanations

Supprime des explications par identifiant. Un identifiant inconnu fait échouer l'appel sans rien supprimer.

refresh_analysis traite les explications comme les constats : une explication dont les lignes ne correspondent plus au texte copié passe à « obsolète », et redevient à jour si elles correspondent de nouveau.

Schémas

Outil

Effet

set_diagram

Crée un schéma, ou remplace entièrement celui de diagram_id. L'agent ne donne que des nœuds et des liens, sans coordonnées ni couleurs : la GUI place et colore. Le résultat contrôle le tracé : No crossing., ou le nombre de croisements avec chaque paire de liens et chaque lien qui traverse un nœud, suivis de conseils (réordonner les nœuds, découper le schéma, changer de sorte). Le schéma est enregistré dans les deux cas.

delete_diagram

Supprime un schéma.

Trois sortes de schéma (kind) :

  • flow — un process, placé de gauche à droite le long des liens. Une branche secondaire sans jonction et le nœud terminal d'une chaîne descendent sous le nœud qui les précède, ce qui garde le flux compact ; les liens qui remontent le flux passent sous le schéma.

  • layers — une colonne par entrée de layers (GUI, API, cœur, stockage…), chaque nœud dans sa couche : le périmètre d'impact.

  • mindmap — un arbre radial autour de sa racine : la carte des concepts. Le schéma doit être un arbre (une seule racine, un seul parent pour chaque autre nœud, aucun cycle) ; sinon set_diagram le refuse en listant les problèmes.

Règles de lisibilité : un sujet par schéma, 5 à 12 nœuds, nœuds déclarés dans l'ordre de lecture (l'ordre de déclaration est l'ordre de départ de chaque rang ou colonne), aucun croisement attendu. Pour flow et layers, le placement part de l'ordre de déclaration et des ordres obtenus par balayages barycentriques, garde celui dont le tracé final a le moins de croisements et de traversées de nœuds, puis échange deux voisins d'un même rang tant que cela en retire. shared/diagram-quality.ts mesure ces croisements sur le tracé de layoutDiagram.

Chaque nœud a un id, un label, une forme shape (box par défaut, pill, decision en losange) et un statut status qui fixe sa couleur : new, modified, impacted, existing (défaut), finding, missing (dessiné en contour). detail s'affiche au survol ; path (fichier modifié de l'analyse) et line rendent le nœud cliquable vers la revue. Un lien a from, to et un label facultatif.

Retour de revue

Outil

Effet

get_review_feedback

Une fois la revue soumise : décision (approve, request_changes, reject), état du traitement (à traiter, ou traité avec sa date et sa note), constats et remarques retenus avec leur détail, et le prompt généré, recopié tel quel. Après une nouvelle soumission, il liste aussi ce qui a changé depuis la version soumise précédente (décision, constats et remarques ajoutés, modifiés ou retirés) et rappelle comment celle-ci avait été traitée. Avant la soumission, ou pendant que le relecteur modifie une revue soumise : l'avancement seul (fichiers revus, constats ignorés, remarques). Lecture seule.

mark_feedback_processed

Marque traité le retour soumis, avec la date et une note facultative (« corrigé par 12785d6e3 et 1ff5baaad », « réponses données en conversation »). Sert quand refresh_analysis ne convient pas : analyse d'un commit précis corrigée dans d'autres commits, remarques auxquelles l'agent a répondu dans la conversation. Le retour reste lisible avec get_review_feedback. Refusé tant que la revue n'est pas soumise ; un nouveau marquage remplace le précédent. Le relecteur peut aussi marquer un retour traité depuis l'accueil de la GUI ; le traitement enregistre son auteur, et get_review_feedback l'indique (« by the agent » ou « by the reviewer »).

Le retour se lit avant refresh_analysis, qui le remplace par une revue vierge : le recalcul vaut traitement, puisqu'il relance la revue.

Une revue soumise est à traiter jusqu'à mark_feedback_processed ou refresh_analysis, sauf une revue approuvée, qui n'a rien à traiter dès sa soumission, qu'elle retienne des points ou non. Dès que le relecteur la modifie (remarque ajoutée, modifiée ou supprimée, constat ignoré ou réactivé), elle repasse en attente, qu'elle ait été traitée ou non : get_review_feedback n'en donne plus que l'avancement, et l'agent n'agit pas sur un retour en cours de modification. La version soumise est conservée, avec son traitement s'il a eu lieu ; à la nouvelle soumission, la revue est de nouveau à traiter et get_review_feedback montre ce qui a changé. Changer la sélection ou la décision se fait en soumettant à nouveau, avec le même effet.

GUI

Outil

Effet

reconnect_gui

Relance le worker GUI et le réenregistre auprès du proxy, par exemple quand le proxy a démarré après le serveur. force: true redémarre même un worker qui semble vivant. En mode APP_PORT, il indique l'état de la GUI et la marche à suivre si elle ne tourne pas.


Boucle de travail type

list_analyses   { project: "mon-projet" }           ← reprendre une analyse existante de la feature ?
create_analysis { repo_path: "C:/dev/mon-projet", project: "mon-projet", title: "Rafraîchissement OAuth",
                  mode: "branch", base: "master", request_text: "…", request_source: "TM-142" }
get_diff        { analysis_id }                     ← numéros de ligne du côté nouveau
update_analysis { analysis_id, objective: "…", approach: "…", attention_points: ["…"],
                  summary: ["…", "…"] }             ← vue d'ensemble et changements fonctionnels
add_explanations { analysis_id, explanations: [...] } ← blocs longs ou complexes, ajoutés ou supprimés
add_findings    { analysis_id, findings: [...] }    ← y compris les requirement_gap
set_diagram     { analysis_id, kind: "flow", nodes: [...], links: [...] }

  … l'agent donne le lien à l'utilisateur, qui relit dans la GUI et enregistre son retour …

list_analyses       { review_state: "to_process" }  ← revues soumises restant à traiter
get_review_feedback { analysis_id }                 ← décision, points retenus, prompt
  … l'agent corrige le code …
refresh_analysis    { analysis_id }                 ← nouveau diff, nouveau tour de revue
  ou, quand les corrections sont dans d'autres commits (analyse d'un commit précis) :
create_analysis { …, base: "<sha>^", head: "<sha>", follow_up_of: analysis_id }  ← revue de suivi
  ou, quand rien n'est à relire (réponses en conversation) :
mark_feedback_processed { analysis_id, note: "réponses données en conversation" }

Revues de suivi

Une revue de suivi est une nouvelle analyse, créée avec create_analysis et follow_up_of, qui relit les corrections apportées au retour soumis d'une analyse précédente : typiquement les commits de correction d'une analyse qui porte sur un commit précis.

  • Seule une analyse dont la revue est soumise peut être suivie, et elle a au plus une revue de suivi : les tours forment une chaîne (tour 1 → tour 2 → …), et le tour suivant suit le dernier.

  • À la création du suivi, le retour de l'analyse suivie est marqué traité par l'agent s'il l'attendait encore, avec la note « Suivie par la revue « … » ». Une revue approuvée ou déjà traitée garde son marquage.

  • get_analysis, list_analyses et get_review_feedback indiquent les liens dans les deux sens ; get_review_feedback propose de créer la revue de suivi, et mark_feedback_processed le rappelle.

  • Dans la GUI, une analyse suivie quitte les filtres d'étape de l'accueil et ne reste visible que dans « Toutes ».

  • Il n'y a pas d'outil pour lier deux analyses après coup.


L'interface

Thème sombre. La barre supérieure porte la marque (un clic ramène à l'accueil), le sélecteur d'analyse groupé par projet avec l'état de revue de chaque analyse (sa valeur est le titre de l'analyse courante, ses refs en infobulle) et, pendant la revue, le bouton « Terminer la revue ».

Accueil (#/)

Les analyses sont rangées par projet, dans des sections repliables. L'en-tête d'un projet compte ses analyses par état de revue. Chaque analyse est une carte séparée des autres. Son titre s'affiche en entier sur toute la largeur et passe à la ligne s'il le faut. Dessous, sur une seconde ligne : ses refs, la date de sa dernière modification, la progression des fichiers revus, ses constats ouverts par gravité (exigences manquantes comprises, ce que dit l'infobulle) et son état de revue : « Non commencée », « En cours », « Fichiers revus » ou « Soumise », suivi de la décision, puis « Traitée » une fois que l'agent a marqué le retour traité (date et note en infobulle) ; la pastille disparaît dès que le relecteur modifie la revue, qui repasse en cours. Quand le retour est marqué traité, une ligne sous les références donne la note, l'auteur du marquage (l'agent, ou le relecteur) et la date. Dans le filtre « À traiter par l'agent », chaque carte porte à droite du titre un bouton « Marquer comme traité » : il ouvre une petite fenêtre avec une note facultative (Entrée confirme, Échap referme), et la revue passe dans « Traitées par l'agent », comme avec mark_feedback_processed. Le reste de la carte mène à l'analyse. Une analyse suivie porte la ligne « Nouvelle revue disponible : » avec un bouton au titre de sa revue de suivi et son état ; une revue de suivi porte « Revue faisant suite à : » avec un bouton au titre de l'analyse suivie et son rang (« tour 2 »). Une analyse suivie n'apparaît que dans « Toutes ». Une colonne à gauche filtre la liste, chaque filtre avec son icône et son nombre d'analyses : « À relire » (par défaut, revues pas encore soumises), « À traiter par l'agent » (retour soumis que l'agent n'a pas encore traité), « Traitées par l'agent » (retour traité, corrections à vérifier), « Approuvées », et « Toutes ». Les quatre premiers ne se recouvrent pas et laissent de côté les analyses qui ont une revue de suivi. Sous 900 px de large, les filtres passent au-dessus de la liste. L'accueil n'ouvre aucune analyse d'office ; sans analyse, il explique que l'agent les crée avec create_analysis.

Écran Feature (#/<id>)

Titre, mode et refs (un sha complet est abrégé à 7 caractères), nombre de fichiers, lignes ajoutées et supprimées, bouton « Commencer la revue » qui ouvre le premier fichier non revu. Quand l'analyse fait partie d'une chaîne de revues, un bandeau suit l'en-tête : sur une analyse suivie, « Nouvelle revue disponible : » et un bouton au titre de sa revue de suivi, avec son état ; sur une revue de suivi, « Revue faisant suite à : » et un bouton au titre de l'analyse suivie, le rappel de son retour (date, décision, traitement) et les « Points du retour précédent à vérifier » (constats et remarques qu'il retenait, en lecture seule). La chaîne des tours (« Tour 1 → Tour 2 »), un lien par tour, accompagne la première ligne. Quatre onglets, avec leur compteur : fichiers modifiés, constats ouverts (exigences manquantes comprises ; l'infobulle donne aussi le total), schémas :

  • Résumé — la carte « Vue d'ensemble » (objectif, approche, points d'attention) quand l'agent l'a rédigée, « Ce que l'agent a fait », la demande initiale et sa source, la section « Constats ouverts » (compteurs par gravité, constats ouverts du plus grave au moins grave, lien « Voir les N constats, tous statuts confondus ») et « Copier le prompt pour l'agent » (tous les constats ouverts).

  • Fichiers — chaque fichier avec son statut, ses +/−, ses constats ouverts par gravité et son état de revue.

  • Constats — la liste complète, tous statuts, filtrable par gravité et par statut (ouvert, ignoré, obsolète) ; les puces comptent tous les statuts ; un clic ouvre le constat dans la revue.

  • Schémas — sélecteur de schéma, qui passe à la ligne quand les schémas sont nombreux (un schéma dont le tracé présente des croisements porte l'étiquette « croisements »), rendu SVG, légende des statuts présents et des gravités des points de constat dessinés (« Constat ouvert (couleur de la gravité la plus haute) »), contrôles « − », « + », « Ajuster » (recentre et adapte le zoom), « Plein écran », et zoom à la molette. Un clic sur un nœud rattaché à un fichier ouvre la revue à ce fichier et à cette ligne. Un schéma qui ne peut pas être placé (carte mentale qui n'est pas un arbre, par exemple) affiche l'erreur à la place du dessin.

Le plein écran passe par l'API Fullscreen du navigateur : le schéma occupe l'écran, légende et contrôles restent visibles, le zoom est réajusté à l'entrée et à la sortie, Échap ou « Quitter le plein écran » en sortent. Si le navigateur refuse, un message l'indique sous le schéma.

L'ajustement à la fenêtre ne descend jamais sous l'échelle 0,85 : en dessous, les libellés deviennent illisibles. Un schéma plus grand s'ouvre sur son début, à cette échelle, et se parcourt en le faisant glisser (curseur main, indication « Glisser pour parcourir le schéma ») ; la vue reste bornée au schéma.

Écran Revue (#/<id>/review/<chemin>)

  • Progression — dans la barre supérieure, à gauche de « Terminer la revue » : « 3/7 revus » et une barre étroite, visibles quel que soit le défilement et même panneau des fichiers masqué.

  • Panneau des fichiers — nombre de fichiers, fichiers groupés par dossier, état revu, pastilles des constats ouverts par gravité et, en bout de ligne, la lettre du statut git à la manière de VS Code : M modifié, A ajouté, D supprimé, R renommé, U non suivi (libellé complet en infobulle). Un nom trop long est tronqué au milieu (reminder-sch…uler.ts), l'extension reste visible et le chemin complet est en infobulle. Chaque pastille est un lien : elle ouvre le fichier sur son premier constat ouvert de cette gravité (?line=N) ; son infobulle le dit (« 3 constats mineurs ouverts — aller au premier »). Après les pastilles de gravité, une pastille violette à marque carrée compte les remarques du relecteur sur le fichier, de ligne ou sur le fichier entier ; elle ouvre le fichier sur la première ligne portant une remarque, ou en tête du fichier quand toutes visent le fichier entier (« 2 remarques — aller à la première »). Sa largeur se règle en glissant son bord droit (entre 200 et 600 px ; flèches gauche et droite quand la poignée a le focus, double-clic pour revenir à 280 px) et se conserve dans le navigateur d'un rechargement à l'autre. Le bouton en tête de l'en-tête du fichier masque ou réaffiche le panneau, pour toute la session : le diff s'élargit vers la gauche, la colonne de droite garde sa largeur. Il reste affiché quand le chemin demandé ne fait pas partie de l'analyse.

  • En-tête du fichier — bascule du panneau des fichiers, entrée dans le mode zen, chemin, +/−, statut, fichier précédent et suivant, « Remarque sur le fichier », « Marquer comme revu ».

  • Diff — code coloré selon le langage du fichier, déduit de son extension ou de son nom (grammaires de Shiki, chargées à la demande) : le côté nouveau à partir du contenu complet du fichier quand le snapshot le conserve, sinon bloc par bloc ; les lignes supprimées bloc par bloc ; chaque correctif proposé séparément ; les lignes barrées par un correctif restent sans couleur. Un fichier dont le langage n'est pas reconnu s'affiche sans coloration ; une grammaire qui ne se charge pas est signalée dans la barre du diff. Numéros du côté nouveau et repère vertical à la couleur de la gravité le long des lignes visées par un constat. La barre du diff porte trois réglages, communs à tous les fichiers et conservés dans le navigateur d'un rechargement à l'autre : chacun est un bouton compact qui affiche sa valeur courante, et un clic ouvre la liste de ses choix, chacun avec son icône et une description d'une ligne (un clic dehors, Échap ou un défilement la referme). « Afficher » choisit entre « Modifications » (les blocs du diff git, entourés de leurs lignes de contexte) et « Fichier entier » (tout le fichier en un seul bloc : les lignes inchangées, tirées du contenu conservé, s'intercalent entre les modifications, ce qui donne à lire en entier une fonction modifiée en son milieu ; les deux autres sélecteurs s'y appliquent de la même façon, un correctif dont les lignes chevauchaient deux blocs s'y affiche, et « Copier une demande d'explication » porte alors sur tout le fichier). En « Fichier entier », une mini-carte de 22 px longe le bord droit du diff et reste à l'écran pendant le défilement : toute sa hauteur représente tout le fichier affiché. Sa piste de gauche place les lignes ajoutées (vert), supprimées (rouge), supprimées et ajoutées en vis-à-vis en vue « Côte à côte » (moitié rouge, moitié verte) ou seulement réindentées (violet) ; sa piste de droite porte un point par constat, à la couleur de sa gravité (atténué s'il n'est plus ouvert), et un point par ligne portant une remarque. Un cadre bleuté suit la portion visible. Le survol d'un repère en donne la description (« 12 lignes ajoutées · lignes 120 à 131 », « Constat 3 · Majeur » et son titre) ; un clic ou un glissé sur la carte fait défiler le diff jusqu'à l'endroit visé. « Fichier entier » est inactif pour un fichier dont le contenu n'est pas conservé ; la liste en donne la raison à la place de sa description. « Code » choisit entre « Unifié » (une seule colonne : lignes supprimées sur fond rouge au-dessus des lignes ajoutées sur fond vert), « Côte à côte » (ancien code à gauche avec ses numéros du côté ancien, nouveau code à droite : lignes de contexte des deux côtés, lignes supprimées et ajoutées appariées ligne à ligne, case hachurée en face d'une ligne sans vis-à-vis ; remarques, repères et lignes proposées par un correctif sont du côté droit, le bandeau d'un correctif sur toute la largeur) et « Nouveau code » (le code du côté nouveau seul, dans les mêmes blocs : les lignes supprimées ne sont pas affichées et les lignes ajoutées portent un fin filet vert à la place de leur fond et de leur marque ; une explication de code supprimé s'aligne alors sur la ligne voisine du bloc). « Correctifs » choisit entre « Sans correctif », « Avant / après » et « Code corrigé ». Le correctif proposé s'affiche à l'endroit où il s'applique : bandeau « Correctif proposé par l'agent — remplace les lignes X à Y » avec le numéro du constat et « Masquer le correctif », lignes visées barrées sur fond ambre, lignes proposées juste en dessous sur fond violet (marque « › », sans numéro). Le correctif est affiché d'office pour un constat ouvert ; masqué, ou pour un constat sans correctif, une pastille numérotée marque la première ligne visée. Un filet sarcelle longe les lignes décrites par une explication. En « Modifications », quand le contenu du fichier est conservé, l'en-tête de chaque bloc porte un réglage « −5 · N lignes · +5 » : « +5 » ajoute cinq lignes de contexte au-dessus et cinq en dessous du bloc, « −5 » les retire, et le compteur donne le nombre de lignes de contexte au-dessus de la première modification. Les lignes ajoutées s'insèrent sous l'en-tête et après le bloc, si bien que le réglage ne bouge pas à l'écran ; elles se distinguent par un fond plus sombre et un filet gris (« Contexte ajouté » dans la légende). Les lignes entre deux blocs vont d'abord au bloc du dessus ; quand plus aucune ligne masquée ne les sépare, les deux blocs n'en forment plus qu'un, sous un seul en-tête dont « +5 » et « −5 » s'appliquent à chacun des blocs réunis. « +5 » s'éteint quand le bloc atteint les bords du fichier. Le contexte choisi est propre à chaque fichier et dure le temps de la session. L'en-tête de chaque bloc porte aussi « Copier une demande d'explication » (icône du robot) : le bouton copie un prompt à coller dans la conversation de l'agent, qui situe le bloc (analyse, dépôt et refs, fichier, lignes des deux côtés, code tel que figé) et lui demande de l'expliquer en enregistrant ses explications avec add_explanations, ou update_explanation si une explication couvre déjà ces lignes. Deux correctifs dont les lignes se recouvrent ne s'affichent pas ensemble. Le fond ambre des lignes visées se distingue du rouge des lignes − supprimées par la feature. Une légende suit le diff, limitée aux fonds que la vue et le mode affichent : « Ajouté par la feature » (fond ou filet selon la vue), « Supprimé par la feature » (Unifié et Côte à côte), « Lignes remplacées par le correctif » (Avant / après), « Correctif proposé » ou « Correctif appliqué », « Code décrit par une explication ». Quand une ligne supprimée et la ligne ajoutée qui la remplace se ressemblent (la moitié de leurs mots au moins en commun), seules leurs parties modifiées sont surlignées, en rouge sur l'ancienne ligne et en vert sur la nouvelle, sans fond sur le reste de la ligne ; dans chaque suite de lignes supprimées puis ajoutées, la i-ème ligne supprimée est comparée à la i-ème ligne ajoutée, mot à mot. Une ligne sans correspondante proche garde son fond entier (« Partie modifiée de la ligne » dans la légende). Un clic sur un numéro de ligne ouvre la saisie d'une remarque sur cette ligne. Les exigences manquantes sans emplacement s'affichent en bandeau au-dessus du diff de chaque fichier ; le bandeau « N exigences manquantes » se replie, et reste replié pour la session.

  • Affichage des correctifs — le sélecteur « Correctifs », au-dessus du diff, propose trois modes, conservés d'un fichier à l'autre et d'un rechargement à l'autre :

    • « Sans correctif » : le diff seul, sans aucun correctif ; les interrupteurs des cartes sont inactifs.

    • « Avant / après » (par défaut) : le rendu décrit ci-dessus, lignes visées barrées puis lignes proposées.

    • « Code corrigé » : le code tel qu'il se lirait avec les correctifs appliqués. Les lignes visées disparaissent ; les lignes proposées prennent leur place, sur fond violet avec la marque « › » et sans numéro, sous un bandeau « Correctif N appliqué — remplace les lignes X à Y ». Un lien ?line=N vers une ligne retirée met ce bandeau en évidence ; les remarques ne se posent que sur les lignes du diff, pas sur les lignes proposées.

    Dans les deux derniers modes, l'interrupteur de chaque carte (« Afficher le correctif dans le code » ou « Appliquer le correctif dans le code ») choisit les correctifs dessinés.

  • Pliage des blocs de code — les blocs du code affiché sont délimités par l'indentation : une ligne ouvre un bloc quand la ligne non vide suivante est plus indentée, et le bloc s'étend jusqu'à la dernière ligne plus indentée qu'elle (l'accolade fermante reste visible). Un chevron, entre le numéro et la marque de la première ligne du bloc, apparaît au survol de la ligne. Un clic replie le bloc, un nouveau clic le déplie ; un bloc replié garde son chevron visible et porte après son texte un repère « ⋯ N lignes » qui le déplie au clic. Un Ctrl+clic replie progressivement : d'abord les sous-blocs les plus imbriqués, puis un niveau de plus à chaque Ctrl+clic, jusqu'au bloc lui-même ; les sous-blocs déjà masqués par un bloc replié sont sautés. Un Ctrl+clic sur un bloc replié le déplie avec tous ses sous-blocs. En vue « Côte à côte », le chevron est du côté droit, sauf pour une ligne supprimée. La mini-carte, le rail des repères et les cartes de la colonne suivent le pliage : les cartes des lignes repliées s'alignent juste sous la première ligne du bloc. Le pliage est propre au fichier affiché et se perd en changeant de fichier.

  • Colonne « Constats et explications » — l'en-tête compte les constats ouverts, et le total quand il diffère (« 4 constats ouverts · 5 au total »). Deux boutons, « Constats » et « Explications », affichent ou masquent chacun leur type, indépendamment l'un de l'autre et pour tous les fichiers de la session ; chacun indique le nombre d'éléments du fichier. Masquer les constats retire aussi leurs repères, pastilles et correctifs du diff et le bandeau des exigences manquantes : on parcourt alors le code avec ses seules explications, avant de rétablir les constats. Masquer les explications retire leurs cartes et leurs filets. Dessous, un index compact des constats (numéro à la couleur de la gravité et première ligne, ignorés et obsolètes atténués) : un clic fait défiler jusqu'aux lignes et à la carte, mises en évidence comme avec ?line. Tant que des cartes de constat sont sous la partie visible, une indication collée en bas de la colonne les compte (« 3 constats plus bas ↓ ») ; un clic amène la suivante. Les constats, numérotés dans l'ordre de leur première ligne, sont des cartes alignées sur leur ligne et reliées au diff ; des cartes voisines s'empilent sans se chevaucher et défilent avec le diff. Chaque carte montre numéro, gravité, lignes, titre, explication, l'interrupteur « Afficher le correctif dans le code » (constat avec correctif) et les boutons « Copier le prompt », « Ignorer » / « Rouvrir », « Remarque ». Les constats ignorés ou obsolètes restent visibles, atténués. Les explications sont des cartes sarcelle alignées de la même façon sur la première ligne qu'elles décrivent, une ligne supprimée pour du code supprimé ; à hauteur égale, l'explication précède les constats. Chaque carte montre les lignes (côté ancien et mention « Code supprimé » pour du code supprimé), le titre et le texte, replié au-delà de huit lignes avec « Lire la suite ». Une explication obsolète est atténuée et signale que le code décrit a changé. Les remarques de ligne sont des cartes alignées de la même façon, datées au format court (date complète en infobulle), avec « Modifier », qui rouvre le texte sur place dans la même saisie que la création, et « Supprimer » ; modifier une remarque retenue dans une revue déjà soumise recalcule le prompt enregistré. Une remarque saisie avec le bouton « Remarque » d'une carte de constat est liée à ce constat : quand l'agent supprime le constat avec delete_findings, la remarque disparaît avec lui. Les remarques posées depuis un numéro de ligne ou sur le fichier entier restent libres. Les remarques sur le fichier entier et ce qui vise des lignes hors du diff affiché sont en tête de colonne. Sous 1200 px de large, la colonne passe sous le diff et ses cartes s'empilent.

  • Mode zen — le bouton à côté de la bascule du panneau des fichiers donne toute la page au code. Il ne reste qu'une barre en haut : marque (lien vers l'accueil), chemin et +/− du fichier, les trois réglages du diff, progression de la revue, sortie du mode zen et « Terminer la revue ». Le panneau des fichiers et la colonne des constats disparaissent ; la mini-carte du « Fichier entier » aussi, remplacée par le rail des repères qui longe le bord droit. Toute la hauteur du rail représente tout ce qui défile ; un cadre bleuté suit la partie visible. Il porte un repère par constat (rond, couleur de sa gravité, grisé s'il n'est plus ouvert), par explication (losange sarcelle) et par remarque de ligne (carré violet) ; des repères trop proches n'en forment qu'un, avec leur nombre. Le survol d'un repère ouvre sa carte à gauche du rail, la même que dans la colonne, avec toutes ses actions (interrupteur du correctif, « Copier le prompt », « Ignorer », « Remarque », modifier ou supprimer une remarque) ; elle reste ouverte tant que le pointeur passe du repère à la carte. Un clic sur le repère fait défiler le diff jusqu'à lui et épingle la carte, comme un clic dans la carte ; Échap ou un clic hors du rail la referme. Un clic ailleurs sur le rail fait défiler le diff jusqu'à l'endroit visé. En haut du rail, une icône réunit les remarques sur le fichier entier et les cartes dont les lignes ne sont pas affichées. « Remarque sur le fichier », fichier précédent et suivant et « Marquer comme revu » flottent en bas au centre ; la saisie d'une remarque, de fichier ou de ligne, s'ouvre juste au-dessus. Le mode dure le temps de la session et vaut pour tous les fichiers. Un fichier binaire, supprimé ou de plus de 1 Mo n'a pas de contenu conservé : on ne peut pas y ancrer de constat ni de remarque de ligne, seulement une remarque sur le fichier entier.

Écran Fin de revue (#/<id>/finish)

Décision (Approuver, Demander des corrections, Rejeter ; « Demander des corrections » est proposée d'emblée dès qu'il y a des points), points à transmettre (constats ouverts et remarques, tous cochés pour une revue jamais soumise, la sélection enregistrée pour une revue déjà soumise ; pour une revue rouverte, la sélection de sa dernière version soumise, les points apparus depuis étant cochés), aperçu du prompt qui se met à jour, « Copier le prompt », « Retour à la revue » et « Enregistrer le retour », qui soumet la revue lue ensuite par get_review_feedback. Un bandeau rappelle le retour enregistré et s'il a été traité par l'agent, avec la note du traitement ; pour une revue modifiée depuis son retour, un bandeau ambre indique que l'agent ne le traite plus jusqu'au prochain enregistrement.

Toute modification faite par l'agent pendant que la GUI est ouverte y apparaît en quelques secondes : la GUI interroge api/changes toutes les 3 s. Chaque action de la GUI porte la révision affichée : si l'analyse a changé entre-temps, l'action est refusée, l'analyse rechargée, et un message invite à refaire l'action.


Architecture

Deux processus, conformément au standard de l'écosystème (@imenam/mcp-gui-interface) :

  • Maître MCP (src/index.ts) — JSON-RPC sur stdio, outils (src/tools/, une fonction pure par outil), logique métier (src/core/), stockage, cycle de vie du worker via GuiLauncher.

  • Worker GUI (src/gui-worker.ts) — serveur Hono, enregistrement auprès du proxy via ProxyClient ou écoute sur APP_PORT, API REST, journal des changements (/api/changes), fichiers de la SPA avec la balise <base> du chemin de montage.

Le worker ne lit ni n'écrit aucune donnée : chaque requête REST est transmise au maître par IPC (messages {type, correlationId, data, error, timestamp} validés par zod) et le maître pousse les changements, que le worker range dans un journal en mémoire (les 200 derniers, numérotés). GET /api/changes?since=<seq>&epoch=<epoch> répond immédiatement : les évènements postérieurs à since, ou reset: true quand le client ne peut pas reprendre (premier appel, epoch d'une autre instance du worker, évènements sortis du journal) ; la GUI recharge alors tout. Un since qui n'est pas un entier positif est refusé (400). Aucune connexion ne reste ouverte : les GUI servies sur la même origine n'épuisent pas les connexions du navigateur. Le worker s'arrête quand le maître disparaît (canal IPC fermé, PID parent absent) ou quand une autre instance est déjà enregistrée, ce qui évite les GUI orphelines.

shared/ est importé à la fois par le serveur et par la GUI : schémas zod (shared/schemas/), prompt de retour (prompt.ts, utilisé par l'aperçu de la GUI et par get_review_feedback), placement des schémas (diagram-layout.ts, fonctions pures testées sous Node) et contrôle de leurs croisements (diagram-quality.ts), état de revue dérivé (review-state.ts), libellés et couleurs des gravités et statuts (labels.ts, severity.ts). Ce que l'utilisateur voit en aperçu est donc exactement ce que l'agent reçoit.

Persistance

Un fichier JSON par analyse dans <données>/analyses/<id>.json, et son diff figé dans <données>/diffs/<id>.json. Les écritures sont atomiques (fichier temporaire puis rename), sérialisées entre processus par un verrou .lock, et le cache mémoire est invalidé dès que la date ou la taille du fichier change. Tout document est validé par zod à la lecture et à l'écriture ; src/core/migrate.ts met à niveau les anciens formats à la lecture : une analyse sans projet reçoit le nom du dossier du dépôt (basename(repoPath)), une analyse sans vue d'ensemble reçoit overview: null, une analyse sans explications reçoit une liste vide.

Invariants

Toute modification, qu'elle vienne d'un outil ou de la GUI, passe par AnalysisStore.mutate(id, editor, fn, { baseRevision }), qui vérifie le schéma et les invariants avant d'écrire et incrémente la révision :

  • refs cohérentes avec le mode (branch : ref et commit de tête ; working_tree : base HEAD, sans tête) ;

  • identifiants uniques (fichiers, constats, explications, remarques, schémas, nœuds d'un schéma) ;

  • un constat ouvert vise un fichier de l'analyse dont le contenu est conservé, avec 1 ≤ startLine ≤ endLine ≤ nombre de lignes ; un issue a un emplacement ;

  • une explication à jour vise un fichier de l'analyse ; côté nouveau, son contenu est conservé et ses lignes existent ;

  • les liens d'un schéma relient des nœuds existants ; en layers, chaque nœud est dans une couche déclarée ;

  • une remarque liée à un constat vise un constat existant ;

  • la revue ne sélectionne que des constats et des remarques existants ;

  • les champs issus du diff (dépôt, refs, commits, liste des fichiers hors « revu ») ne changent que par refresh_analysis.

Les deux modes de diff

  • branch — git diff --find-renames <base>...<head> : ce que la branche apporte depuis son point de départ. head vaut HEAD par défaut. Le contenu des fichiers est lu dans le commit de tête : en local, en deux commandes git quel que soit le nombre de fichiers (ls-tree, puis cat-file --batch) ; en rôle remote, par un cat-file blob <commit>:<chemin> par fichier.

  • working_tree — git diff --find-renames HEAD : les modifications non commitées, index compris, plus les fichiers non suivis (hors .gitignore), au statut « Non suivi » (untracked, lettre U). Le contenu est lu sur disque.

Le diff est figé à la création. refresh_analysis le recalcule : un fichier revu dont le diff n'a pas changé reste revu, les autres repassent à revoir ; un constat ouvert dont les lignes ne correspondent plus au texte copié passe à « obsolète », un constat obsolète dont les lignes correspondent de nouveau redevient ouvert ; la revue repart vierge.

Rien n'est écrit dans le dépôt

Le serveur lance git sans shell, uniquement en lecture (rev-parse, diff, ls-tree, cat-file, ls-files), et lit les fichiers de la copie de travail. En rôle remote, ce sont les mêmes commandes git, plus un node qui écrit un fichier sur sa sortie standard, exécutées par le relais agent dans repo_path, avec GIT_LITERAL_PATHSPECS=1 pour qu'un nom de fichier ne soit jamais lu comme un motif. Les correctifs proposés ne sont qu'affichés et transmis dans le prompt. repo_path doit être la racine absolue d'un dépôt git ; tout autre chemin est refusé avec un message explicite.

Exposition réseau de la GUI

La GUI montre le code des dépôts analysés et ses retours sont lus par l'agent : elle n'est joignable que depuis la machine elle-même, avec la garde de requêtes de @imenam/mcp-gui-interface (honoGuiGuard).

  • Le worker écoute sur 127.0.0.1 uniquement (GUI_LISTEN_HOST). L'accès depuis un autre poste passe par le proxy ou le gateway manager et leur authentification ; tous deux relaient vers localhost:<port>.

  • L'en-tête Host doit désigner la boucle locale : une page tierce qui fait pointer son propre domaine vers 127.0.0.1 est refusée (403).

  • Une requête de modification venant d'un autre site est refusée (403) : Sec-Fetch-Site doit valoir same-origin ou none et, en son absence, l'hôte de l'Origin doit être la machine ou le proxy. Une page web ouverte dans le navigateur ne peut pas soumettre de revue à la place du relecteur.


Développement

npm install
npm run build   # version, backend (tsc -> dist/), puis GUI (gui/dist)
npm test        # node --test sur dist/test
cd gui && npm run lint   # oxlint

Dossier

Contenu

src/index.ts

Maître MCP : déclaration des outils, instructions, IPC, lancement de la GUI.

src/gui-worker.ts

Worker GUI : Hono, REST, journal des changements, fichiers statiques, proxy.

src/tools/

Un fichier par outil, (store, args) => résultat.

src/core/

Stockage, git (local : git.ts ; machine de l'agent : agent-repo.ts, gateway-exec.ts), rôle, parseur de diff, emplacements, invariants, recalcul, actions du relecteur.

src/cli/setup-mcp.ts

Commande --claude-setup-mcp.

shared/

Code commun au serveur et à la GUI.

gui/

Application Vite + React 19 + zustand, CSS écrit à la main.

test/

Tests node --test.

La suite comprend des tests unitaires (parseur de diff, git sur de vrais dépôts temporaires, en local et à travers un relais agent simulé, store, invariants, emplacements, recalcul, prompt, placement des schémas), des tests de chaque outil, et deux suites qui lancent un vrai serveur sur stdio :

  • test/gui-api.test.ts — la GUI en mode standalone sur un port libre : API REST, journal api/changes et boucle agent → GUI → agent. Elle ne dépend de rien d'extérieur.

  • test/e2e.test.ts — l'enregistrement auprès du proxy (E2E_PROXY_URL, défaut http://localhost:3000), la balise <base>, api/changes et reconnect_gui. Sans proxy joignable, elle est ignorée plutôt qu'en échec.

Pour inspecter le worker sans traverser le proxy, ajoutez ?__direct=1 à l'URL de son port local : les assets ne sont alors pas préfixés par le chemin de montage.

Publication

Chaque push sur master, merge de pull request compris, publie une nouvelle version de @imenam/mcp-feature-analyzer sur npm (.github/workflows/publish.yml) : npm ci, build et tests, puis npm version patch, dont le commit et le tag sont poussés sur master, et npm publish. La publication passe par le trusted publishing de npm (OIDC, sans token), avec attestation de provenance. Un échec du build ou des tests arrête le workflow avant la montée de version.

Sur npmjs.com, le paquet déclare ce workflow comme publieur de confiance (Settings → Trusted publishing → GitHub Actions : Matthieu-Pesnot-Pin, mcp-feature-analyzer, publish.yml, avec npm publish dans les actions autorisées). Le commit de version est poussé avec GITHUB_TOKEN : si master est protégée, la règle doit autoriser GitHub Actions à y pousser.

Available Tools

17 tools
add_explanationsA

Explain blocks of added or removed code to the reviewer, as a batch: what each block does and how it works. Write one for every long (about 30 lines or more) or complex block; skip trivial code. An explanation judges nothing: problems go in findings. Each location is checked against the frozen diff and its lines are copied; if any explanation is invalid, nothing is added and every problem is reported.

Inputs: analysis_id (required), explanations (required).

add_findingsA

Record findings for the reviewer, as a batch. Each location is checked against the frozen diff and its lines are copied; if any finding is invalid, nothing is added and every problem is reported. Include requirement_gap findings for requested behaviour that is missing.

Inputs: findings (required), analysis_id (required).

create_analysisA

Create an analysis once a feature is developed: computes and freezes the git diff of the repository for human review. In branch mode the diff is base...head (head defaults to HEAD); in working_tree mode it is the uncommitted changes, index included, against HEAD. Returns the id and the changed files; then read them with get_diff.

Inputs: mode (required), title (required), project (required), repo_path (required), +4 more.

delete_analysisA

Delete an analysis and its frozen diff. The repository is not touched. Also removes an analysis listed as unreadable.

Inputs: analysis_id (required).

delete_diagramC

Delete a diagram from an analysis.

Inputs: diagram_id (required), analysis_id (required).

delete_explanationsA

Delete explanations by id, e.g. when the code they describe is gone. If any id is unknown, nothing is deleted.

Inputs: analysis_id (required), explanation_ids (required).

delete_findingsA

Delete findings by id, typically once refresh_analysis shows them solved. If any id is unknown, nothing is deleted.

Inputs: analysis_id (required), finding_ids (required).

get_analysisA

Read a whole analysis: project, request, overview, summary, files (reviewed or not), findings with their status and location, reviewer notes, diagrams (flagged when their layout has crossings) and review state. Use it to check what is already recorded before adding more.

Inputs: analysis_id (required).

get_diffA

Read the frozen diff of one file, or of every file when path is omitted, with the old and the new line number of each line. Use the NEW-side numbers (second column) for every finding location and diagram node line.

Inputs: analysis_id (required), path.

get_review_feedbackA

Read the reviewer's feedback once the review is submitted: decision, selected findings and notes, and the prompt to act on. Before submission it reports the review progress. Read-only. Always read the feedback before calling refresh_analysis, which discards it.

Inputs: analysis_id (required).

list_analysesA

List the analyses grouped by project, with their refs, open findings by severity, reviewed files, diagram count and review state (not started, in progress, all files reviewed, submitted). Start here: when the project already has an analysis of the feature, continue it (update_analysis to rewrite the overview and summary, refresh_analysis after changing the code) instead of creating a duplicate; create a new one with create_analysis for another feature or another diff.

Inputs: project.

reconnect_guiA

Relaunch the GUI worker and re-register it with the proxy server. Use this when the proxy server was not running when the MCP server started (so the GUI registration failed), to redeploy the GUI without restarting the MCP server. Does nothing if the GUI is already registered, unless force=true.

Inputs: force.

refresh_analysisA

Recompute the frozen diff with the same repository, mode and refs, after fixing the code. Files whose diff changed become unreviewed, findings whose lines changed become outdated, and the review restarts as pending: the previous feedback is discarded, so read it with get_review_feedback first.

Inputs: analysis_id (required).

set_diagramA

Create a diagram, or fully replace the one with diagram_id, when a picture helps the reviewer (impact perimeter, process flow, concept map). Give nodes and links only, with no coordinates or colours: the GUI lays the diagram out and colours nodes by status. flow = a process with steps and decisions, laid out left to right along the links, where a side branch without a join and the last node of a chain hang below the node before them; layers = the impact perimeter, one column per entry of layers (e.g. GUI, API, core, storage), each node in its layer; mindmap = a tree of concepts drawn radially around its root: exactly one root, one incoming link for every other node, no cycle (refused otherwise). Rules: one subject per diagram, 5 to 12 nodes; declare nodes in reading order, since the declaration order is the initial order of every rank or column; zero crossings expected. The result reports every link crossing and every link through a node, with advice: reorder the nodes, split the diagram or change its kind, then send it again.

Inputs: kind (required), nodes (required), title (required), analysis_id (required), +3 more.

update_analysisA

Change the title, the project, the overview, the summary or the initial request of an analysis. Right after reading the diff, write the overview (objective, approach, attention_points: your global analysis of the feature) and the summary (the functional changes of the feature, one bullet per change, not one bullet per file). Give at least one field; fields left out are kept.

Inputs: analysis_id (required), title, project, summary, +5 more.

update_explanationA

Change one explanation: title, body or location. A new location (path and start_line, with side for removed code) is checked against the diff and makes an outdated explanation current again; rewrite the body too when the code changed.

Inputs: analysis_id (required), explanation_id (required), body, path, +4 more.

update_findingA

Change the fields of one finding: severity, kind, title, body, location, suggestion or prompt. A new location is checked against the diff and reopens an outdated finding; path null removes the location. Whether a finding is ignored is the reviewer's decision and cannot be changed here.

Inputs: finding_id (required), analysis_id (required), body, kind, +7 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 17 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action (analysis lifecycle, findings, explanations, diagrams, diff, review feedback), with detailed descriptions clarifying boundaries. Potential confusion between add/update/delete variants is mitigated by singular/batch distinctions.

    Naming Consistency4/5

    All tools use snake_case with a verb_noun pattern (e.g., create_analysis, get_diff). Minor inconsistency: plural in add_findings/add_explanations/delete_* but singular in update_finding/update_explanation.

    Tool Count4/5

    17 tools cover a complex workflow with CRUD for analyses, findings, explanations, and diagrams. Slightly above the ideal 15 but each tool appears necessary and well-scoped.

    Completeness4/5

    Covers full analysis lifecycle, diff retrieval, findings/explanations/diagrams CRUD, review feedback, and GUI reconnect. Minor gap: no explicit read tool for explanations (though get_analysis may include them) and no standalone list for findings/explanations.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      A collaborative code and markdown review tool that bridges human reviewers and AI agents, enabling both to browse files, inspect git diffs, leave structured comments, and save a final review report from the same UI in real time.
      68 PyPI
      2
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Lets AI coding agents hand off in-progress work to real human reviewers, who pin comments to the exact elements that are wrong and send back a verdict. The agent then revises and re-files until a person approves, so only human-signed-off output reaches the user.
      38 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI coding agents to publish their work mid-task and hand it to a real human reviewer, who pins comments to the exact elements that are off and returns an approval verdict. The agent then iterates on that human feedback until the work is signed off.
      38 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI coding agents to file work for review by a real human, who opens the published artifact and returns comments pinned to the exact elements that are off along with a verdict. The agent then revises and refiles, iterating through human checks until the work is approved.
      38 npm
      MIT