« OpenCode et Graphify sur mercurius » : différence entre les versions
Création de la procédure reproductible OpenCode, Graphify et Hermes MCP |
Documenter la mise à jour OpenCode 2.0.32 / Graphify 0.9.92 sur tas et la validation MCP |
||
| Ligne 87 : | Ligne 87 : | ||
* Désinstaller le paquet OpenCode : `npm uninstall --global opencode-ai`. | * 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. | * Conserver une copie de `graphify-out/graph.json` si elle est utile avant de retirer le clone ou l’environnement virtuel. | ||
== Mise à jour du 17 octobre 2026 — tas/Linux == | |||
=== Périmètre === | |||
Cette intervention concerne '''tas/Linux''', pour le projet <code>orp-tui</code>, et non l'installation Windows de mercurius. Elle est documentée dans une section distincte de la page MediaWiki « OpenCode et Graphify sur mercurius » ; les versions et procédures Windows antérieures sont conservées comme historique, sans prétendre qu'elles ont été mises à jour. | |||
=== Résultat vérifié === | |||
* OpenCode v2 : '''2.0.32''', paquet npm <code>@opencode/cli</code>, dernière version publiée lors du contrôle. | |||
* Graphify : '''0.9.92''', paquet Python <code>graphifyy</code>, dernière version PyPI lors du contrôle. | |||
* Serveur MCP Graphify : négociation réussie, version annoncée '''0.9.92''', dix outils découverts. | |||
* Appel MCP réel <code>graph_stats</code> : '''812 nœuds, 1 555 arêtes, 0 communauté''' ; <code>is_error=false</code>. | |||
* OpenCode, depuis <code>/home/loic/prog/orp-tui</code> : <code>✓ graphify connected</code>, code de sortie 0. | |||
* API OpenCode v2 <code>/api/mcp</code> avec paramètre <code>location[directory]</code> : le répertoire retourné est bien celui du projet et Graphify est <code>connected</code>. | |||
* Graphe et configuration globale OpenCode identiques à la sauvegarde (comparaison SHA-256 pour le graphe, comparaison octet par octet pour la configuration). | |||
=== Installation et sauvegarde === | |||
La mise à jour a été exécutée avec : | |||
<pre> | |||
npm install --global --prefix /home/loic/.npm-global @opencode/cli@2.0.32 | |||
uv tool upgrade graphifyy | |||
</pre> | |||
Sauvegarde préalable : <code>/home/loic/backups/opencode-graphify.bak-2026-10-17T14-23-22+0200/</code> (<code>installation.tar.gz</code>, <code>manifest.json</code>). Elle contient l'installation OpenCode ciblée, l'environnement uv Graphify, la configuration globale OpenCode et la configuration du projet. Le manifeste enregistre aussi l'empreinte du graphe existant. | |||
Graphe préservé : <code>/home/loic/.graphify/projects/orp-tui/graphify-out/graph.json</code>. | |||
SHA-256 avant/après : <code>b9fbd4c5ddfe647727c22f54eb724c07cf631b04c12a56255c302df1779f5cf2</code>. | |||
=== Adaptation MCP v2 === | |||
Seul le bloc MCP du fichier <code>/home/loic/prog/orp-tui/opencode.json</code> a été migré vers le schéma v2. Les autres paramètres du projet ont été conservés ; la configuration globale n'a pas été modifiée. | |||
<pre> | |||
{ | |||
"mcp": { | |||
"servers": { | |||
"graphify": { | |||
"type": "local", | |||
"command": [ | |||
"/home/loic/.local/bin/graphify-mcp", | |||
"/home/loic/.graphify/projects/orp-tui/graphify-out/graph.json" | |||
], | |||
"disabled": false, | |||
"codemode": false, | |||
"timeout": {"startup": 15000, "catalog": 15000, "execution": 60000} | |||
} | |||
} | |||
} | |||
} | |||
</pre> | |||
L'ancien bloc <code>mcp.graphify</code> produisait <code>No MCP servers configured</code> ; <code>mcp.servers.graphify</code> permet désormais la connexion. L'intégration reste locale à ce projet afin de ne pas exposer son graphe aux autres projets. | |||
=== Commandes de vérification === | |||
<pre> | |||
/home/loic/.npm-global/bin/opencode --version | |||
/home/loic/.local/bin/graphify --version | |||
cd /home/loic/prog/orp-tui | |||
/home/loic/.npm-global/bin/opencode mcp list | |||
</pre> | |||
Résultats observés : | |||
<pre> | |||
opencode v2.0.32 | |||
graphify 0.9.92 | |||
✓ graphify connected | |||
</pre> | |||
La connexion et l'appel <code>graph_stats</code> ont également été testés avec le client Python MCP officiel, depuis l'environnement uv de Graphify, via transport stdio, sans écriture du graphe. | |||
=== Limites et coexistence === | |||
* Le test piloté par un modèle (<code>opencode run --model ollama/gemma4:26b-a4b-it-q8_0 --format json</code>, demande d'appel à <code>graph_stats</code>) a expiré après 80 secondes, code 124, sans réponse exploitable. La connexion MCP et l'appel direct sont validés ; le parcours complet prompt → modèle → MCP ne l'est pas. La cause de cette expiration n'est pas établie. | |||
* L'ancienne installation <code>opencode-ai</code> 1.18.32 sous nvm est toujours présente ; elle n'a pas été supprimée. Le shell de vérification résout <code>opencode</code> vers <code>/home/loic/.npm-global/bin/opencode</code>. Utiliser ce chemin explicite si un autre terminal sélectionne encore la version 1. | |||
* Aucun nouvel extrait du projet, aucune réindexation du graphe, aucune modification volontaire de fichiers source, aucun commit/push. | |||
=== Retour arrière prudent === | |||
Conserver la sauvegarde. Avant restauration, arrêter proprement les sessions OpenCode et faire une nouvelle copie des fichiers actuels. L'archive contient les configurations antérieures ; une restauration globale non sélective pourrait écraser des changements postérieurs. Ne pas extraire aveuglément sur le répertoire personnel. | |||
=== Sources === | |||
* OpenCode v2, MCP : https://opencode.ai/v2/docs/mcp-servers/ | |||
* OpenCode v2, API : https://opencode.ai/v2/docs/api/ | |||
* Graphify : https://github.com/Graphify-Labs/graphify | |||
* Métadonnées npm : https://registry.npmjs.org/@opencode%2fcli/latest | |||
* Métadonnées PyPI : https://pypi.org/pypi/graphifyy/json | |||
== Pages liées == | == Pages liées == | ||
* [[Configuration détaillée de mercurius]] | * [[Configuration détaillée de mercurius]] | ||
* [[Suivi des actions sur mercurius]] | * [[Suivi des actions sur mercurius]] | ||
Dernière version du 17 octobre 2026 à 16:56
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.
Mise à jour du 17 octobre 2026 — tas/Linux
Périmètre
Cette intervention concerne tas/Linux, pour le projet orp-tui, et non l'installation Windows de mercurius. Elle est documentée dans une section distincte de la page MediaWiki « OpenCode et Graphify sur mercurius » ; les versions et procédures Windows antérieures sont conservées comme historique, sans prétendre qu'elles ont été mises à jour.
Résultat vérifié
- OpenCode v2 : 2.0.32, paquet npm
@opencode/cli, dernière version publiée lors du contrôle. - Graphify : 0.9.92, paquet Python
graphifyy, dernière version PyPI lors du contrôle. - Serveur MCP Graphify : négociation réussie, version annoncée 0.9.92, dix outils découverts.
- Appel MCP réel
graph_stats: 812 nœuds, 1 555 arêtes, 0 communauté ;is_error=false. - OpenCode, depuis
/home/loic/prog/orp-tui:✓ graphify connected, code de sortie 0. - API OpenCode v2
/api/mcpavec paramètrelocation[directory]: le répertoire retourné est bien celui du projet et Graphify estconnected. - Graphe et configuration globale OpenCode identiques à la sauvegarde (comparaison SHA-256 pour le graphe, comparaison octet par octet pour la configuration).
Installation et sauvegarde
La mise à jour a été exécutée avec :
npm install --global --prefix /home/loic/.npm-global @opencode/cli@2.0.32 uv tool upgrade graphifyy
Sauvegarde préalable : /home/loic/backups/opencode-graphify.bak-2026-10-17T14-23-22+0200/ (installation.tar.gz, manifest.json). Elle contient l'installation OpenCode ciblée, l'environnement uv Graphify, la configuration globale OpenCode et la configuration du projet. Le manifeste enregistre aussi l'empreinte du graphe existant.
Graphe préservé : /home/loic/.graphify/projects/orp-tui/graphify-out/graph.json.
SHA-256 avant/après : b9fbd4c5ddfe647727c22f54eb724c07cf631b04c12a56255c302df1779f5cf2.
Adaptation MCP v2
Seul le bloc MCP du fichier /home/loic/prog/orp-tui/opencode.json a été migré vers le schéma v2. Les autres paramètres du projet ont été conservés ; la configuration globale n'a pas été modifiée.
{
"mcp": {
"servers": {
"graphify": {
"type": "local",
"command": [
"/home/loic/.local/bin/graphify-mcp",
"/home/loic/.graphify/projects/orp-tui/graphify-out/graph.json"
],
"disabled": false,
"codemode": false,
"timeout": {"startup": 15000, "catalog": 15000, "execution": 60000}
}
}
}
}
L'ancien bloc mcp.graphify produisait No MCP servers configured ; mcp.servers.graphify permet désormais la connexion. L'intégration reste locale à ce projet afin de ne pas exposer son graphe aux autres projets.
Commandes de vérification
/home/loic/.npm-global/bin/opencode --version /home/loic/.local/bin/graphify --version cd /home/loic/prog/orp-tui /home/loic/.npm-global/bin/opencode mcp list
Résultats observés :
opencode v2.0.32 graphify 0.9.92 ✓ graphify connected
La connexion et l'appel graph_stats ont également été testés avec le client Python MCP officiel, depuis l'environnement uv de Graphify, via transport stdio, sans écriture du graphe.
Limites et coexistence
- Le test piloté par un modèle (
opencode run --model ollama/gemma4:26b-a4b-it-q8_0 --format json, demande d'appel àgraph_stats) a expiré après 80 secondes, code 124, sans réponse exploitable. La connexion MCP et l'appel direct sont validés ; le parcours complet prompt → modèle → MCP ne l'est pas. La cause de cette expiration n'est pas établie. - L'ancienne installation
opencode-ai1.18.32 sous nvm est toujours présente ; elle n'a pas été supprimée. Le shell de vérification résoutopencodevers/home/loic/.npm-global/bin/opencode. Utiliser ce chemin explicite si un autre terminal sélectionne encore la version 1. - Aucun nouvel extrait du projet, aucune réindexation du graphe, aucune modification volontaire de fichiers source, aucun commit/push.
Retour arrière prudent
Conserver la sauvegarde. Avant restauration, arrêter proprement les sessions OpenCode et faire une nouvelle copie des fichiers actuels. L'archive contient les configurations antérieures ; une restauration globale non sélective pourrait écraser des changements postérieurs. Ne pas extraire aveuglément sur le répertoire personnel.
Sources
- OpenCode v2, MCP : https://opencode.ai/v2/docs/mcp-servers/
- OpenCode v2, API : https://opencode.ai/v2/docs/api/
- Graphify : https://github.com/Graphify-Labs/graphify
- Métadonnées npm : https://registry.npmjs.org/@opencode%2fcli/latest
- Métadonnées PyPI : https://pypi.org/pypi/graphifyy/json