๐ 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รฉ.


