@ogygie/mcp 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 x10sion LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# @ogygie/mcp
+
+Serveur MCP du framework Ogygie : il donne à un espace de conception
+(claude.ai, Claude Desktop, Claude Code) un accès **en lecture** aux fichiers
+de gouvernance et aux features de N repos Ogygie — sans copie, sans recherche
+sémantique, sans connaître le produit. **Le manifeste est l'index** : une
+feature qu'il ne déclare pas n'existe pas.
+
+## Lancement
+
+```bash
+# Depuis un projet Ogygie, sur le projet courant
+pnpm add -D @ogygie/mcp@<version d'@ogygie/cli>   # lockstep D2
+pnpm ogygie mcp
+
+# Sur un hôte, sans projet Ogygie, en servant plusieurs repos
+npx @ogygie/mcp --config ogygie-mcp.config.json --http --port 3010
+```
+
+Le registre nomme les repos servis :
+
+```json
+{
+  "repos": [
+    { "id": "mon-produit", "rootPath": "/srv/clones/mon-produit" },
+    { "id": "autre-produit", "rootPath": "/srv/clones/autre-produit" }
+  ]
+}
+```
+
+Sans `--config`, le serveur sert le projet courant sous l'id `local`.
+
+## Outils
+
+| Outil | Ce qu'il rend |
+|---|---|
+| `ogygie_list_repos` | les repos servis, leur version Ogygie, le ref git lu |
+| `ogygie_read_manifest` | le manifeste validé — l'index du repo |
+| `ogygie_list_specs` | les specs (id, statut, priorité, dépendances, différés) |
+| `ogygie_read_spec` | une spec entière : frontmatter parsé + corps |
+| `ogygie_read_decisions` | une décision `D<n>`, ou les deux fichiers entiers |
+| `ogygie_read_governance` | `AGENTS.md`, `AGENTS.product.md` ou `FAILURES.md` |
+| `ogygie_read_feature` | les fichiers d'une feature, ou l'un d'eux |
+
+Chaque réponse porte sa provenance `{ repo, path, ref }` : ce qui a été lu, où,
+et à quel commit.
+
+## Transport HTTP
+
+`OGYGIE_MCP_TOKEN` est **obligatoire** (32 caractères au moins) : sans lui, le
+serveur refuse de démarrer. Les requêtes portent `Authorization: Bearer <token>`
+et sont refusées avant toute lecture. Le serveur n'écoute que `127.0.0.1` tant
+qu'un `--host` n'est pas écrit à la main. La synchronisation des clones
+(`git fetch`) est un problème d'hébergement : le serveur lit ce que le disque
+porte, et le date par `ref`.
+
+## Ce qu'il ne fait pas
+
+Aucune écriture — pas de spec créée ni amendée, pas de commit. Aucune exécution
+de code du repo servi. Aucun accès hors carte : `.env`, secrets et artefacts de
+build sont inatteignables par construction, pas par liste noire. Aucun cache :
+chaque lecture touche le disque, la fraîcheur est l'objectif.
+
+## Licence
+
+MIT — voir `LICENSE`.