đ MCP Vault
Coffre-fort de secrets pour agents IA, fondé sur OpenBao et exposé via le Model Context Protocol (MCP).
đŹđ§ English version
Profil PostgreSQL standalone : installation, quatre parcours et retour contrÎlé.
MCP Vault centralise les secrets, les politiques dâaccĂšs et les accĂšs temporaires dont ont besoin des agents IA. Il embarque OpenBao pour le chiffrement et le stockage, ajoute une API MCP protĂ©gĂ©e par authentification et politiques, puis fournit une console dâadministration et une CLI.
Version : 0.20.1 · Licence : Apache-2.0
[!IMPORTANT] MCP Vault est un composant de sĂ©curitĂ© Ă exploiter dans un environnement maĂźtrisĂ©. Lisez le modĂšle de sĂ©curitĂ© et le rapport dâaudit avant toute mise en production.
Console dâadministration
Fonctionnalités
- Coffres isolés et secrets versionnés dans OpenBao KV v2.
- Authentification bearer obligatoire par défaut, politiques par outil, coffre et chemin.
- Mode Mission JWT optionnel avec validation du jeton, binding local et refus fail-close.
- AccĂšs temporaires : wrapping Ă usage unique, certificats SSH et PKI interne.
- Console web, CLI et journal dâaudit JSONL.
- WAF Caddy/Coraza fourni par Docker Compose.
- Persistance locale avec synchronisation vers un stockage S3 compatible.
Architecture
Client MCP / CLI / navigateur
â
âŒ
Caddy + Coraza WAF
â
âŒ
MCP Vault (ASGI / MCP)
â â â
â â âââ Authentification, politiques et audit
â ââââââââââââ Console dâadministration
ââââââââââââââââââââ OpenBao embarquĂ© (KV, SSH, PKI)
â
âââ Volume Docker local
âââ Synchronisation S3
Le conteneur applicatif nâest pas publiĂ© directement par la configuration Docker Compose : le trafic passe par le WAF. Lâarchitecture complĂšte et les contrats dâexploitation sont dĂ©crits dans ARCHITECTURE.md.
Démarrage rapide
Prérequis
- Docker avec le plugin Compose ;
- un stockage S3 compatible ;
- une clĂ© bootstrap dâadministration gĂ©nĂ©rĂ©e et conservĂ©e comme un secret.
Installation
git clone https://github.com/Cloud-Temple/mcp-vault.git
cd mcp-vault
cp .env.example .env
Avant de démarrer, renseignez au minimum dans .env :
ADMIN_BOOTSTRAP_KEYavec une valeur alĂ©atoire forte conforme aux exigences documentĂ©es dans.env.example;S3_ENDPOINT_URL,S3_ACCESS_KEY_ID,S3_SECRET_ACCESS_KEY,S3_BUCKET_NAMEetS3_REGION_NAME;- les noms dâhĂŽte autorisĂ©s si le service est exposĂ© derriĂšre votre propre domaine.
Ne commitez jamais le fichier .env.
docker compose up -d --build
# Liveness du processus
curl -fsS http://localhost:8085/healthz
# Disponibilité du coffre et readiness
curl -fsS http://localhost:8085/health
curl -fsS http://localhost:8085/ready
Points dâentrĂ©e par dĂ©faut :
La CLI et ses prérequis Python locaux sont documentés dans scripts/README.md.
Outils MCP
La version actuelle expose 39 outils MCP. Le catalogue canonique est contrÎlé automatiquement contre les outils enregistrés par le serveur.
[!CAUTION]
secret_wrap_lookupnâest pas une simple consultation : cette compensation peut rĂ©voquer les wraps correspondants, tandis que certains Ă©tats peuvent rester non rĂ©voquĂ©s ou indĂ©terminĂ©s. Utilisezsecret_wrap_statuspour une inspection sans rĂ©vocation.
ModÚle de sécurité
- Les secrets sont chiffrĂ©s au repos par la barriĂšre cryptographique dâOpenBao.
- Le matĂ©riel dâunseal est chiffrĂ© en AES-256-GCM avant son stockage sur S3 ; la clĂ© bootstrap reste sĂ©parĂ©e.
- Le mode
bearerexige un jeton valide. Les modes Mission JWT et dual-stack sont disponibles pour les intégrations qui appliquent leur contrat complet. - Les politiques limitent les outils, les vaults et les chemins accessibles.
- Les magasins de policies, de bindings Mission et de wraps refusent les décisions fondées sur un instantané périmé lorsque S3 ne permet plus leur rafraßchissement. Exception documentée : le Token Store peut continuer à authentifier son cache bearer périmé, tandis que
/healthet/readysignalent lâinstance indisponible. - Le WAF filtre lâentrĂ©e HTTP, mais ne remplace ni la segmentation rĂ©seau ni la gestion des secrets dâinfrastructure.
Limites Ă connaĂźtre
- DĂ©ploiement mono-instance : OpenBao est embarquĂ© et la synchronisation S3 est de type last-write-wins. MCP Vault nâest pas un cluster active-active et ne doit pas ĂȘtre rĂ©pliquĂ© horizontalement tel quel.
- DurabilitĂ© asynchrone : le volume local est la copie active ; S3 sert Ă la restauration et Ă la synchronisation. Un arrĂȘt brutal peut laisser la derniĂšre copie distante en retard.
- Audit local : le journal JSONL vit sur un volume local. Il nâest ni synchronisĂ© vers S3, ni immuable, ni WORM. Exportez-le vers votre systĂšme de journalisation si ces propriĂ©tĂ©s sont requises.
- Wrapping : le TTL borne lâenveloppe de livraison, pas la durĂ©e de vie du credential externe quâelle contient.
- Mémoire et réponses : un secret autorisé existe nécessairement en clair dans la mémoire du processus et dans la réponse remise au client autorisé.
- ClĂ© bootstrap : prĂ©sentĂ©e au service, elle donne un accĂšs dâadministration total ; sa compromission est dĂ©jĂ un incident majeur. CombinĂ©e Ă celle du stockage S3, elle compromet aussi la protection des donnĂ©es persistĂ©es et du matĂ©riel dâunseal.
Consultez le rapport dâaudit pour les risques rĂ©siduels et les mesures de rĂ©duction associĂ©es.
Configuration
Le fichier .env.example est la référence exhaustive et testée. Les principaux groupes sont :
Les valeurs sensibles doivent ĂȘtre injectĂ©es au dĂ©ploiement, jamais intĂ©grĂ©es dans une image ni commitĂ©es dans Git.
Le proxy ACME supporte aussi les endpoints clients natifs liés à un rÎle. La publication réseau, l'admission EAB et les restrictions du rÎle restent à configurer cÎté opérateur : voir le contrat PKI.
Développement et tests
python -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python -m pytest -q
Certaines suites dâintĂ©gration nĂ©cessitent Docker, S3 et un serveur en fonctionnement. Le guide des tests dĂ©crit les niveaux, prĂ©requis et commandes ciblĂ©es ; le catalogue E2E documente les scĂ©narios couverts.
Documentation
Licence
MCP Vault est distribué sous licence Apache License 2.0.
Métadonnées PostgreSQL (profil opt-in)
Le guide public décrit l'installation Vault-first, les deux topologies autonomes, les credentials/rÎles séparés, les lectures metadata bornées et la reprise logique. En ce profil, la clé bootstrap est réservée à la voie opérateur finie ; elle ne donne aucun accÚs admin métier. Les secrets et backups OpenBao conservent leur mécanisme existant.
Listener TLS natif pour un opérateur
Le listener HTTP 127.0.0.1:8200 reste inchangé. Un deuxiÚme listener natif
OpenBao peut ĂȘtre activĂ© explicitement avec les trois variables
OPENBAO_OPERATOR_TLS_ADDRESS, OPENBAO_OPERATOR_TLS_CERT_FILE et
OPENBAO_OPERATOR_TLS_KEY_FILE (toutes vides par défaut). L'adresse est une IPv4
RFC1918 littérale avec port explicite, par exemple 172.16.80.9:8420 ; cet exemple
n'alloue aucun réseau. L'interface doit exister dÚs la création du conteneur,
avant le démarrage Bao. Garder OPENBAO_ADDR à http://127.0.0.1:8200.
DĂ©poser certificat PEM et clĂ© non chiffrĂ©e hors du backend, dans un rĂ©pertoire 0700 appartenant Ă l'UID serveur ; mĂȘme propriĂ©taire pour les fichiers, clĂ© 0400/0600, certificat non inscriptible par groupe/autres, aucun lien symbolique. Le serveur vĂ©rifie les fichiers et la paire avant son startup ; les scripts peuvent charger les Settings sans ces mounts. TLS minimum 1.2 est imposĂ©. Ne publier aucun port hĂŽte ni route WAF : ce listener donne accĂšs Ă l'API native, dont les policies sont distinctes des permissions MCP. RĂ©server son rĂ©seau aux acteurs opĂ©rateur explicitement autorisĂ©s, avec CA et nom de serveur vĂ©rifiĂ©s.
Activer sur un coffre déjà initialisé, ou n'attacher avant init que des acteurs
opérateur de confiance : sys/init est non authentifié pendant le bootstrap
Source. Aucun outil MCP n'active ce listener. Une ancienne image peut ignorer
ces nouvelles variables d'environnement ; vérifier la révision et la health
HTTPS réelle. Si le manager réutilise un Bao déjà joignable, sa configuration
n'est pas régénérée : TLS peut manquer, le client doit refuser sans repli HTTP.
Les limites d'architecture
précisent les responsabilités ; aucun déploiement automatique n'est ajouté.


