mcp-framework/docs/bootstrap-cli.md

Bootstrap CLI

Le package bootstrap fournit un point d'entrée CLI uniforme pour les binaires MCP. Il gère le parsing des arguments, l'aide, les alias et le routage vers les hooks fournis par l'application.

Commandes disponibles

Commande	Description
setup	Initialiser ou mettre à jour la configuration locale
login	Authentifier et déverrouiller Bitwarden pour persister BW_SESSION
mcp	Démarrer le serveur MCP
config show	Afficher la configuration résolue et la provenance des valeurs
config test	Vérifier la configuration et la connectivité
config delete	Supprimer un profil local
update	Auto-update du binaire
version	Afficher la version

Les commandes sans hook correspondant sont automatiquement masquées de l'aide et retournent une erreur ErrUnknownCommand. Exception : version affiche Options.Version si fourni, sans hook.

Utilisation

func main() {
	err := bootstrap.Run(context.Background(), bootstrap.Options{
		BinaryName:        "my-mcp",
		Description:       "Client MCP",
		Version:           version,
		EnableDoctorAlias: true,
		Hooks: bootstrap.Hooks{
			Setup: func(ctx context.Context, inv bootstrap.Invocation) error {
				return runSetup(ctx, inv.Args)
			},
			Login: bootstrap.BitwardenLoginHandler("my-mcp"),
			MCP: func(ctx context.Context, inv bootstrap.Invocation) error {
				return runMCP(ctx, inv.Args)
			},
			ConfigShow: func(ctx context.Context, inv bootstrap.Invocation) error {
				return runConfigShow(ctx, inv.Args)
			},
			ConfigTest: bootstrap.StandardConfigTestHandler(bootstrap.StandardConfigTestOptions{
				OpenStore:         openStore,
				ConnectivityCheck: connectivityCheck,
			}),
			Update: func(ctx context.Context, inv bootstrap.Invocation) error {
				return runUpdate(ctx, inv.Args)
			},
		},
	})
	if err != nil {
		log.Fatal(err)
	}
}

Handlers fournis

BitwardenLoginHandler

bootstrap.BitwardenLoginHandler(binaryName string) bootstrap.Handler

Handler prêt à l'emploi pour la commande login des MCPs qui utilisent le backend Bitwarden CLI. Il lance le flux interactif bw unlock --raw, persiste BW_SESSION dans un fichier 0600 sous le répertoire de config utilisateur, et confirme le résultat.

À n'utiliser que si le MCP déclare secret_store.backend_policy = "bitwarden-cli" dans son manifest. Pour les autres backends (env-only, keyring-any), ne pas définir de hook Login : la commande est automatiquement masquée.

Hooks: bootstrap.Hooks{
	Login: bootstrap.BitwardenLoginHandler(mcpgen.BinaryName),
}

StandardConfigTestHandler

bootstrap.StandardConfigTestHandler(opts bootstrap.StandardConfigTestOptions) bootstrap.Handler

Handler pour config test qui exécute un ensemble de checks standards et affiche un rapport formaté. Aucun champ n'est obligatoire.

type StandardConfigTestOptions struct {
	ConfigCheck       cli.DoctorCheck                  // cli.NewConfigCheck(store)
	OpenStore         func() (secretstore.Store, error) // check disponibilité secret store
	ConnectivityCheck cli.DoctorCheck                  // check applicatif (HTTP, IMAP…)
	ExtraChecks       []cli.DoctorCheck
}

Checks inclus automatiquement selon les champs fournis :

Champ	Check résultant
ConfigCheck	Fichier de configuration lisible
OpenStore	Secret store disponible
ConnectivityCheck	Connectivité applicative
ExtraChecks	Checks supplémentaires

Le ManifestCheck n'est pas inclus : le manifest est un artefact de build, pas une contrainte runtime.

ConfigTest: bootstrap.StandardConfigTestHandler(bootstrap.StandardConfigTestOptions{
	ConfigCheck: cli.NewConfigCheck(frameworkconfig.NewStore[ProfileConfig]("my-mcp")),
	OpenStore:   openSecretStore,
	ConnectivityCheck: func(ctx context.Context) cli.DoctorResult {
		if err := pingBackend(ctx); err != nil {
			return cli.DoctorResult{
				Name:    "connectivity",
				Status:  cli.DoctorStatusFail,
				Summary: "backend inaccessible",
				Detail:  err.Error(),
			}
		}
		return cli.DoctorResult{
			Name:    "connectivity",
			Status:  cli.DoctorStatusOK,
			Summary: "backend accessible",
		}
	},
}),

Pour un config test applicatif spécifique (appels API, messages ✓/✗), implémenter un hook ConfigTest custom.

Options

Champ	Description
BinaryName	Nom du binaire, utilisé dans l'aide et les messages
Description	Description affichée dans l'aide globale
Version	Version affichée par version sans hook
Args	Arguments CLI (défaut : os.Args[1:])
Stdin/Stdout/Stderr	I/O (défaut : os.Stdin/Stdout/Stderr)
Aliases	Alias de commandes
AliasDescriptions	Descriptions des alias dans l'aide
EnableDoctorAlias	Active doctor comme alias de config test
DisabledCommands	Commandes à masquer explicitement

Le flag global --debug active le debug des appels Bitwarden (MCP_FRAMEWORK_BITWARDEN_DEBUG=1).