mcp-framework/docs/getting-started.md

# Installation et utilisation type

## Installation

```bash
go get gitea.lclr.dev/AI/mcp-framework
```

## CLI de scaffold

Pour initialiser un projet MCP depuis un dossier vide, sans écrire de runner Go :

```bash
go install gitea.lclr.dev/AI/mcp-framework/cmd/mcp-framework@latest
mcp-framework scaffold init \
  --target ./my-mcp \
  --module example.com/my-mcp \
  --binary my-mcp \
  --profiles dev,prod
```

Puis dans le projet généré :

```bash
cd my-mcp
go mod tidy
go run ./cmd/my-mcp help
```

## Utilisation type

Le flux typique côté application est :

1. Déclarer les sous-commandes communes via `bootstrap` (optionnel).
2. Résoudre le profil actif avec `cli`.
3. Charger la config versionnée avec `config`.
4. Lire les secrets avec `secretstore`.
5. Charger le manifest runtime avec `manifest` (`mcp.toml` local, ou fallback embarqué).
6. Exécuter l'auto-update avec `update` si nécessaire.
7. Exécuter `doctor` pour diagnostiquer la configuration locale et brancher des checks métier.