🔐 MCP Vault
Coffre-fort de secrets pour agents IA, fondé sur OpenBao et exposé via le Model Context Protocol (MCP).
Profil PostgreSQL standalone : installation, quatre parcours et retour contrôlé.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
Coffre-fort de secrets pour agents IA, fondé sur OpenBao et exposé via le Model Context Protocol (MCP).
Profil PostgreSQL standalone : installation, quatre parcours et retour contrôlé.
🔐 MCP Vault — Gestion sécurisée des secrets pour agents IA (OpenBao embedded). 39 outils MCP, SSH CA, policies, audit, 14 types de secrets style 1Password.
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.
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.
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_KEY avec 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_NAME et S3_REGION_NAME ;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.
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.
bearer exige un jeton valide. Les modes Mission JWT et dual-stack sont disponibles pour les intégrations qui appliquent leur contrat complet./health et /ready signalent l’instance indisponible.Consultez le rapport d’audit pour les risques résiduels et les mesures de réduction associées.
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.
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.
MCP Vault est distribué sous licence Apache License 2.0.
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.
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é.
🔐 MCP Vault — Gestion sécurisée des secrets pour agents IA (OpenBao embedded). 39 outils MCP, SSH CA, policies, audit, 14 types de secrets style 1Password.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
MCP Vault 透過 stdio 在本機執行。
上次檢查時間:2026-11-13。 🔐 MCP Vault — Gestion sécurisée des secrets pour agents IA (OpenBao embedded). 39 outils MCP, SSH CA, policies, audit, 14 types de secrets style 1Password.