OpenCode et Graphify sur mercurius
Objet
Cette page documente une installation locale et reproductible d’OpenCode et de Graphify sur mercurius, la connexion de Graphify à Hermes par MCP et une analyse statique d’un exemple JavaScript/Java. Le dépôt d’exemple reste un clone local ; aucun fichier amont n’a été modifié ni commité.
Sources et versions
- Graphify officiel : https://github.com/Graphify-Labs/graphify — paquet Python `graphifyy`, licence Apache-2.0.
- OpenCode officiel : https://opencode.ai/docs/ — paquet npm `opencode-ai`.
- Exemple : https://github.com/in28minutes/full-stack-with-react-and-spring-boot — licence MIT, branche `master`, commit analysé `4d3b555346e28f4738b70b4b966dddf552fb7bf2`.
- OpenCode installé : `opencode-ai` 1.18.35. Graphify CLI installé : 0.9.83.
Installation reproductible
Les commandes ci-dessous sont écrites pour PowerShell. L’environnement Python Graphify est isolé sous `%LOCALAPPDATA%/mercurius-graphify/venv` afin de ne pas installer ses dépendances dans l’environnement Hermes.
npm install --global --allow-scripts=opencode-ai opencode-ai@1.18.35 $Root = "$env:LOCALAPPDATA/mercurius-graphify" python -m venv "$Root/venv" & "$Root/venv/Scripts/python.exe" -m pip install "graphifyy[mcp,sql]==0.9.83"
Le CLI Graphify n’est pas ajouté au `PATH` global. Dans cette installation, l’appeler par son chemin : %LOCALAPPDATA%/mercurius-graphify/venv/Scripts/graphify.exe.
Dépôt d’exemple et Graphify pour OpenCode
Le dépôt MIT choisi contient un client React en JavaScript et un backend Spring Boot en Java. Il a été cloné sans exécuter l’application ni installer ses dépendances npm/Maven.
$Root = "$env:LOCALAPPDATA/mercurius-graphify" git clone --depth 1 --branch master https://github.com/in28minutes/full-stack-with-react-and-spring-boot.git "$Root/sample-app" Set-Location "$Root/sample-app" & "$Root/venv/Scripts/graphify.exe" extract . --code-only --no-cluster --max-workers 4 --force & "$Root/venv/Scripts/graphify.exe" opencode install
L’intégration locale OpenCode écrit `AGENTS.md`, `.opencode/opencode.json` et `.opencode/plugins/graphify.js`. `AGENTS.md` précise le chemin du CLI isolé sur cette machine. Les sorties Graphify restent dans `graphify-out/` et les fichiers d’intégration ne sont pas commités.
Configuration Hermes MCP
Depuis la racine du dépôt d’exemple, ajouter le serveur stdio à la configuration du profil Hermes actif :
$Root = "$env:LOCALAPPDATA/mercurius-graphify"
hermes mcp add graphify --command "$Root/venv/Scripts/python.exe" --connect-timeout 60 --args -m graphify.serve '${workspaceFolder}${/}graphify-out${/}graph.json'
Dans le sélecteur proposé par Hermes, choisir `select`, puis désactiver `list_prs`, `get_pr_impact` et `triage_prs` ; conserver les sept outils d’exploration du graphe et confirmer. Cette sélection évite d’exposer les fonctions GitHub PR inutiles à cette analyse.
Outils retenus : `query_graph`, `get_node`, `get_neighbors`, `get_community`, `god_nodes`, `graph_stats`, `shortest_path`.
Vérifications effectuées :
hermes mcp test graphify hermes mcp list hermes config get mcp_servers.graphify.tools.include
Le test MCP s’est connecté et a découvert les 10 outils du serveur ; la configuration Hermes en sélectionne 7. Les nouvelles connexions s’appliquent après redémarrage d’une session Hermes ou avec `/reload-mcp`.
Analyse Graphify de l’exemple
Extraction AST locale, sans passe LLM :
& "$Root/venv/Scripts/graphify.exe" extract . --code-only --no-cluster --max-workers 4 --force & "$Root/venv/Scripts/graphify.exe" query 'TodoDataService retrieveAllTodos axios' --context calls --budget 1000 & "$Root/venv/Scripts/graphify.exe" query 'TodoJpaResource getAllTodos findByUsername' --context calls --budget 1000
Résultat du graphe : 386 nœuds et 705 arêtes, sans clustering. L’extraction a traité 55 fichiers de code ; le mode `--code-only` a ignoré la documentation et les médias.
Chaîne front-end → API
- `frontend/todo-app/src/Constants.js` définit `JPA_API_URL` comme `http://localhost:8080/jpa`.
- `frontend/todo-app/src/api/todo/TodoDataService.js`, méthode `retrieveAllTodos(name)`, appelle `axios.get` sur `${JPA_API_URL}/users/${name}/todos`.
- Graphify relie `ListTodosComponent.refreshTodos()` à `TodoDataService.retrieveAllTodos()` par une arête `calls` extraite.
API Java
- `restful-web-services/src/main/java/com/in28minutes/rest/webservices/restfulwebservices/todo/TodoJpaResource.java` expose `@GetMapping("/jpa/users/{username}/todos")` dans `getAllTodos`.
- Cette méthode délègue à `TodoJpaRepository.findByUsername(username)` ; Graphify marque ce lien `INFERRED`.
La comparaison des deux côtés confirme le contrat HTTP GET `/jpa/users/{username}/todos`. Graphify n’a trouvé aucun chemin (dirigé ou non dirigé) entre les méthodes JavaScript et Java : la chaîne d’URL côté client et l’annotation Spring ne sont pas représentées comme un appel de code direct dans ce graphe. Le rapprochement du contrat HTTP reste donc une vérification manuelle appuyée sur les sources.
Limites constatées
- Un fichier `ListTodosComponent.jsx` a été partiellement extrait : erreur de syntaxe signalée à la ligne 1, avec 8 symboles récupérés.
- Six fichiers de code ont produit zéro symbole, notamment des fichiers de données/tests et des fichiers Maven.
- Le dépôt n’a pas été construit ni lancé ; cette procédure est une analyse statique AST, pas un test fonctionnel ou un audit de sécurité exhaustif.
- OpenCode et son fournisseur de modèle n’ont pas été authentifiés/configurés dans cette tâche. L’analyse réalisée l’a été directement avec le CLI Graphify.
Retour arrière
- Retirer la connexion Hermes : `hermes mcp remove graphify`.
- Retirer l’intégration OpenCode du clone : exécuter `graphify opencode uninstall` à la racine de `sample-app`.
- Désinstaller le paquet OpenCode : `npm uninstall --global opencode-ai`.
- Conserver une copie de `graphify-out/graph.json` si elle est utile avant de retirer le clone ou l’environnement virtuel.