convez.ai
MCP ServerSegurançaAvançado
Cloud-Temple

MCP Vault — Cofre de Segredos para Agentes IA

Cloud-Temple/mcp-vault

Cofre de segredos com OpenBao embutido para agentes IA e missões

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que fornece um cofre de segredos seguro para agentes IA, com OpenBao (fork open-source do HashiCorp Vault) embutido. Oferece 24 ferramentas MCP, autoridade de certificado SSH, políticas, auditoria e suporte a 14 tipos de segredos compatíveis com 1Password. Inclui console de administração, gestão de chaves unseal de 3 fatores e sincronização periódica com S3.

Instalação

$npx convez-ai Cloud-Temple/mcp-vault

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
1
Saúde
50%
Último commit
há 1 dia
Versão
v0.22.0
Issues abertas
16
Contribuidores
2

Casos de uso

  • Armazenar e rotacionar segredos de agentes IA em produção
  • Gerenciar credenciais SSH e certificados com autoridade certificadora
  • Auditoria completa e rastreamento de acessos a segredos
  • Integração segura de múltiplos tipos de segredos (BD, API, SSH, tokens)

Veredito

Solução enterprise-grade para gestão de segredos em ambientes de agentes IA. Bem documentada (arquitetura, auditoria de segurança, testes e2e), mas requer infraestrutura Docker/S3 e conhecimento avançado de secrets management. Ideal para equipes que precisam de conformidade e rastreabilidade.

README

A tradução para o português deste README ainda está na fila.

🔐 MCP Vault

Gestion sécurisée des secrets pour agents IA — OpenBao embedded

🇬🇧 English version

MCP Vault est un serveur MCP qui fournit un coffre-fort de secrets pour les agents IA et les missions. Il embarque OpenBao (fork open-source de HashiCorp Vault, Linux Foundation) comme moteur de chiffrement.

Pensez 1Password, mais pour vos agents IA.

📸 Console d'administration

DashboardVaults & SecretsAudit & Alertes
DashboardVaultsAudit

📖 Documentation

DocumentDescription
ARCHITECTURE.mdSpécification complète — vision, architecture ASGI 6 couches, vaults, SSH CA, policies MCP (6 exemples prêts à l'emploi), sécurité des clés unseal (3 facteurs), roadmap HSM
TECHNICAL.mdDocumentation technique — modules source (incl. PKI v0.5.1), stack ASGI 6 couches, Docker, tests, dépendances, roadmap
SECURITY_AUDIT.mdRapport d'audit de sécurité consolidé — 60 findings V2.1, 28 corrigés, 13 résiduels documentés
scripts/README.mdGuide CLI complet — 7 groupes de commandes, shell interactif, exemples
tests/README.mdGuide d'exécution des tests — 4 niveaux, ~600 tests, commandes pour auditeurs
TEST_CATALOG.mdCatalogue des tests e2e — 15 catégories, 312 assertions, objectif de chaque section (pour auditeurs)

⚡ Démarrage rapide

# 1. Cloner et configurer
cp .env.example .env
# Adapter les credentials S3 dans .env

# 2. Build et démarrer
docker compose build
docker compose up -d

# 3. Vérifier (depuis le conteneur)
docker compose exec mcp-vault python scripts/mcp_cli.py health

# 4. Tester (312 tests e2e)
docker compose exec mcp-vault python tests/test_e2e.py

Lifecycle automatique

Au démarrage, MCP Vault :

  1. Charge les tokens depuis S3
  2. Restaure les données OpenBao (volume Docker ou S3)
  3. Démarre OpenBao, l'initialise (1ère fois) et le déverrouille
  4. Clés unseal : chiffrées (AES-256-GCM) sur S3, jamais en clair sur disque — uniquement en mémoire
  5. Active le sync S3 périodique (60s)

À l'arrêt (docker compose stop) :

  1. Scelle OpenBao 🔒
  2. Upload final vers S3 📤
  3. Arrête le processus — clés effacées de la mémoire

🛠️ Outils MCP (31)

System (2)

OutilDescription
system_healthÉtat de santé (OpenBao + S3)
system_aboutInformations service (version, outils, plateforme)

💡 Introspection : l'endpoint /admin/api/whoami et la commande CLI whoami permettent de vérifier l'identité et les permissions du token courant.

Vaults — coffres de secrets (5)

OutilPermDescription
vault_create(vault_id, description?)writeCrée un vault (mount KV v2) + métadonnées (owner, date)
vault_list()readListe les vaults accessibles (filtrés par token)
vault_info(vault_id)readDétails d'un vault (métadonnées, secrets_count, owner)
vault_update(vault_id, description)writeMet à jour la description d'un vault
vault_delete(vault_id, confirm)adminSupprime un vault et tous ses secrets ⚠️

Secrets (6)

OutilPermDescription
secret_write(vault_id, path, data, type?)writeÉcrit un secret typé
secret_read(vault_id, path, version?)readLit un secret (dernière version ou spécifique)
secret_list(vault_id, path?)readListe les clés d'un vault
secret_delete(vault_id, path)writeSupprime un secret et toutes ses versions
secret_types()readListe les 14 types de secrets
secret_generate_password(length?, ...)readGénère un mot de passe CSPRNG

SSH Certificate Authority (5)

Chaque vault possède sa propre CA SSH isolée — les CA sont cryptographiquement différentes entre vaults. Un certificat signé par la CA d'un vault ne fonctionne PAS sur les serveurs configurés pour un autre vault.

OutilPermDescription
ssh_ca_setup(vault_id, role, allowed_users?, ttl?)writeConfigure une CA SSH + rôle dans un vault
ssh_sign_key(vault_id, role, public_key, ttl?)readSigne une clé publique → certificat éphémère
ssh_ca_public_key(vault_id)readClé publique CA (pour TrustedUserCAKeys sur les serveurs)
ssh_ca_list_roles(vault_id)readListe les rôles SSH CA configurés dans un vault
ssh_ca_role_info(vault_id, role)readDétails d'un rôle (TTL, allowed_users, extensions)

Policies MCP — contrôle d'accès granulaire (4)

Les policies permettent de restreindre finement les outils accessibles par token, avec support des wildcards (system_*, ssh_*...) et des règles par vault (prod-* → lecture seule).

OutilPermDescription
policy_create(policy_id, description?, allowed_tools?, denied_tools?, path_rules?)adminCrée une policy avec règles d'accès
policy_list()adminListe les policies avec compteurs
policy_get(policy_id)adminDétails complets (allowed/denied tools, path_rules)
policy_delete(policy_id, confirm)adminSupprime une policy ⚠️

📋 6 policies prêtes à l'emploi documentées dans ARCHITECTURE.md §6.4.1 : readonly, ssh-operator, developer, prod-reader-dev-writer, ci-cd-agent, security-auditor

Token Management (1)

OutilPermDescription
token_update(hash_prefix, policy_id?, permissions?, vaults?)adminModifier un token existant (policy, permissions, vaults)

PKI interne — CA + ACME (7) (v0.5.0)

CA souveraine pour l'écosystème : les WAF Caddy s'enrôlent via ACME exactement comme avec Let's Encrypt, mais sur une CA interne isolée du réseau public. Utilisable en lab (*.lesur.lan) et en prod air-gapped.

OutilPermDescription
pki_ca_setup(lab_mode, allowed_domains, leaf_ttl)adminInitialise CA racine + intermédiaire + rôle ACME
pki_ca_public_key()readCA racine PEM, empreinte SHA-256, URL stable
pki_ca_list_roles()readListe les rôles d'émission
pki_ca_role_info(role_name)readDétails rôle (domaines, TTL, flags TLS)
pki_list_certs(limit?, offset?)adminInventaire paginé des certificats émis
pki_revoke_cert(serial_number)adminRévocation + mise à jour CRL
pki_ca_rotate_intermediate(keep_old_issuer?, overlap_ttl?)adminRotation CA intermédiaire sans coupure

Endpoints publics (non-auth, standard ACME/PKI) : /acme/directory, /pki/ca/root.pem, /pki/ca/chain.pem, /pki/ca/crl.pem

PKI_BASE_URL (optionnel) : URL de base pour les CDPs et le cluster path OpenBao ACME. Vide = déduit de MCP_ALLOWED_HOSTS. Override test Docker : http://mcp-vault:8030. Doit être http(s)://.

Audit (1)

OutilPermDescription
audit_log(limit?, client?, vault_id?, tool?, category?, status?, since?)adminJournal d'audit filtrable (ring buffer 5000 entrées + JSONL persistant)
# 1. Setup initial (ONE-TIME) — créer vault + rôles SSH
vault_create("llmaas-infra", description="SSH CA LLMaaS")
ssh_ca_setup("llmaas-infra", "adminct", allowed_users="adminct", ttl="1h")
ssh_ca_setup("llmaas-infra", "agentic", allowed_users="agentic,iaagentic", ttl="30m")

# 2. Déployer la CA sur les serveurs (ONE-TIME)
result = ssh_ca_public_key("llmaas-infra")
# → Mettre result["public_key"] dans /etc/ssh/trusted-user-ca-keys.pem

# 3. Usage quotidien — signer une clé publique
cert = ssh_sign_key("llmaas-infra", "adminct", public_key="ssh-ed25519 AAAA...", ttl="1h")
# → cert["signed_key"] = certificat signé, valide 1h
# → OpenSSH l'utilise automatiquement si placé à côté de la clé privée

🔑 Types de secrets (style 1Password)

TypeIcôneChamps requisUsage
login🔑username, passwordIdentifiants web/app
password🔒passwordMot de passe simple
secure_note📝contentNotes sécurisées
api_key🔌keyClés API
ssh_key🗝️private_keyPaires de clés SSH
database🗄️host, username, passwordConnexions BDD
server🖥️host, usernameAccès serveur
certificate📜certificate, private_keyCertificats TLS/SSL
env_file📄contentFichiers .env
credit_card💳number, expiry, cvvCartes bancaires
identity👤nameIdentités
wifi📶ssid, passwordRéseaux Wi-Fi
crypto_wallet₿(tout optionnel)Wallets crypto
custom⚙️(champs libres)Tout le reste

Chaque secret supporte : tags, favorite, versioning KV v2 automatique.


🔒 Authentification

⚠️ Seul le header Authorization: Bearer <token> est accepté. L'authentification par query string (?token=) a été supprimée pour des raisons de sécurité (v0.3.1).

Authorization: Bearer <token>
PermissionLectureÉcritureAdmin
read✅❌❌
write✅✅❌
admin✅✅✅

3 couches d'isolation :

  1. Vault-level : allowed_resources=[] → owner-based (seuls les vaults créés par le token), ou liste explicite
  2. Tool-level : policies avec allowed_tools/denied_tools (wildcards fnmatch)
  3. Path-level : allowed_paths dans les path_rules → contrôle par secret individuel

🖥️ CLI

MCP Vault inclut un CLI complet avec Click + Rich + shell interactif :

# Commandes scriptables
python scripts/mcp_cli.py health
python scripts/mcp_cli.py about
python scripts/mcp_cli.py whoami                       # Identité du token courant
python scripts/mcp_cli.py vault list
python scripts/mcp_cli.py vault create serveurs-prod -d "Clés SSH prod"
python scripts/mcp_cli.py secret write serveurs-prod web/github -d '{"username":"me","password":"s3cr3t"}' -t login
python scripts/mcp_cli.py secret read serveurs-prod web/github
python scripts/mcp_cli.py secret password -l 32
python scripts/mcp_cli.py token create agent-sre --vaults prod --policy readonly
python scripts/mcp_cli.py token list
python scripts/mcp_cli.py policy create no-ssh -d "Pas de SSH" --denied "ssh_*"
python scripts/mcp_cli.py policy create team-x --allowed "secret_*" --path-rules '[{"vault_pattern":"shared-*","allowed_paths":["shared/*"]}]'
python scripts/mcp_cli.py audit --status denied --limit 10

# PKI interne (v0.5.0)
python scripts/mcp_cli.py pki setup --lab --domains '*.lesur.lan,lesur.lan'
python scripts/mcp_cli.py pki ca-key
python scripts/mcp_cli.py pki certs
python scripts/mcp_cli.py pki revoke 12:34:ab:cd:ef:12:34:56

# Shell interactif
python scripts/mcp_cli.py shell

L'aide --help de chaque commande explique le modèle de sécurité à 3 couches et guide l'utilisateur.

Voir scripts/README.md pour la documentation complète du CLI.


🏗️ Architecture

📐 Documentation complète : le dossier DESIGN/mcp-vault/ contient la spécification détaillée (ARCHITECTURE.md — vision, sécurité, SSH CA, policies, roadmap HSM) et la documentation technique (TECHNICAL.md — modules, Docker, tests, dépendances).

Internet → WAF (Caddy + Coraza :8085) → MCP Vault (Python :8030) → OpenBao (:8200 localhost)
                  ↕ OWASP CRS v4                  ↕
              Protection L7                 S3 Dell ECS (persistance)

WAF — Caddy + Coraza (OWASP CRS v4)

Le WAF protège l'API contre les attaques L7 (injections SQL, XSS, LFI, RCE, SSRF) :

  • Caddy v2.11.2 compilé avec coraza-caddy v2.2.0 via xcaddy
  • 24 règles OWASP CoreRuleSet v4.7.0 chargées
  • Mode Blocking sur TOUS les endpoints (health, /mcp, /admin/api)
  • 2 exclusions ciblées pour faux positifs JSON-RPC : Unicode français (920540), noms PowerShell (932120)
  • Headers de sécurité : CSP, X-Frame-Options DENY, X-XSS-Protection, nosniff
  • Méthodes autorisées adaptées au protocole MCP : GET, POST, DELETE, PUT, PATCH

Stack ASGI (6 couches)

PkiMiddleware → AdminMiddleware → HealthCheckMiddleware → AuthMiddleware → LoggingMiddleware → FastMCP

PkiMiddleware (v0.5.0) est la couche la plus externe — intercepte /acme/* et /pki/ca/*.pem avant l'auth (endpoints publics par design PKI/ACME).

Lifecycle OpenBao

STARTUP:  S3 download → bao server → init/unseal → periodic sync
RUNTIME:  secrets via hvac → sync S3 toutes les 60s
SHUTDOWN: seal → S3 upload final → stop process
CRASH:    Docker volume local → redémarrage immédiat

Sécurité des clés unseal

Les clés unseal d'OpenBao sont protégées par séparation physique à 3 facteurs :

FacteurStockageCompromis seul = insuffisant
Données chiffrées (barrier OpenBao)Volume Docker + S3Illisibles sans unseal key
Clés unseal (chiffrées AES-256-GCM)S3 uniquementIndéchiffrables sans bootstrap key
ADMIN_BOOTSTRAP_KEYVariable d'env uniquementInutile sans les clés chiffrées

Invariants : les clés unseal ne sont jamais en clair sur disque — uniquement en mémoire pendant le runtime. Un crash efface automatiquement les clés.

Roadmap sécurité :

VersionApproche
v0.5.1 (actuel)Clés sur S3 chiffrées AES-256-GCM+AAD, mémoire seule au runtime — 60 findings audités (28 corrigés, 13 résiduels documentés)
v1.0Transit Auto-Unseal via OpenBao dédié (KMS Cloud Temple)
v2.0Connexion HSM (Hardware Security Module) Cloud Temple — les clés ne quittent jamais le module matériel certifié

📖 Voir DESIGN/mcp-vault/ARCHITECTURE.md §8 et §11 pour les détails complets.


📋 Tests (~600 tests, zéro mocking)

📖 Voir tests/README.md pour le guide complet d'exécution.

# 1. Tests CLI — parsing + affichage (197 tests, SANS serveur)
python tests/test_cli_all.py

# 2. Tests CLI LIVE — cycle complet (79 tests, serveur réel)
MCP_URL=http://localhost:8085 MCP_TOKEN=<key> python tests/test_cli_live.py

# 3. Tests e2e MCP (312 tests, dans Docker)
docker compose exec mcp-vault python tests/test_e2e.py

# 4. Tests crypto (18 tests, SANS serveur — AES-256-GCM + AAD + validation entropie)
python tests/test_crypto.py

# Un seul groupe CLI
python tests/test_cli_all.py --only policy

# Un seul groupe e2e
docker compose exec mcp-vault python tests/test_e2e.py --test enforcement

Couverture e2e (312 tests, 15 catégories)

CatégorieTestsDescription
Système7health, about, services, tools_count (24)
Vault CRUD28create + métadonnées, list, info + owner, update, delete, confirm, erreurs
Secrets CRUD2410 types écrits, read/list/delete, validation
Versioning8v1→v2→v3, read latest, read spécifique
Passwords14longueurs, options, exclusions, CSPRNG
Isolation7secrets cloisonnés entre vaults
Erreurs10edge cases, vault inexistant, type invalide, protection _vault_meta
S3 Sync3archive tar.gz sur S3
SSH CA33setup, rôles multiples, signature ed25519, list/info roles, isolation CA, cleanup
Types1414 types vérifiés individuellement
Admin API15health, whoami, generate-password, logs, unicité CSPRNG
Policies MCP43CRUD, validation, wildcards, path_rules, doublons, erreurs, Admin API REST
Policy Enforcement37check_policy, token_update, denied/allowed, changement policy, Admin API
Audit Log31audit_log MCP, filtres (category/tool/status/since/limit), stats, Admin API /audit
WAF Security17LFI, SQLi, XSS, RCE, Scanner Detection → 403 + non-régression requêtes légitimes

📁 Structure du projet

mcp-vault/
├── .env.example              # Configuration (copier en .env)
├── docker-compose.yml        # WAF + MCP Vault + volumes
├── Dockerfile                # Multi-stage (OpenBao 2.5.1 + Python 3.12)
├── requirements.txt          # Dépendances Python
├── requirements.lock         # Dépendances pinnées (versions exactes)
├── VERSION                   # 0.5.1
├── DESIGN/mcp-vault/
│   ├── ARCHITECTURE.md       # Spécification détaillée (v0.2.2-draft)
│   ├── TECHNICAL.md          # Documentation technique (v0.4.16)
│   └── SECURITY_AUDIT.md     # Rapport d'audit consolidé (60 findings V2.1)
├── scripts/
│   ├── mcp_cli.py            # CLI entry point
│   ├── README.md             # Documentation CLI
│   └── cli/                  # Module CLI (Click + Rich + prompt-toolkit)
│       ├── __init__.py       # Config (.env, BASE_URL, TOKEN)
│       ├── client.py         # MCPClient (Streamable HTTP)
│       ├── commands.py       # 7 groupes Click
│       ├── display.py        # Affichage Rich
│       └── shell.py          # Shell interactif
├── src/mcp_vault/
│   ├── config.py             # Configuration pydantic-settings
│   ├── server.py             # FastMCP + 24 outils MCP + lifecycle + audit
│   ├── lifecycle.py          # Orchestrateur startup/shutdown
│   ├── s3_client.py          # Client S3 hybride SigV2/SigV4
│   ├── s3_sync.py            # Sync file backend ↔ S3
│   ├── auth/                 # Bearer tokens, check_access, ContextVar
│   ├── admin/                # Console web /admin + API REST
│   ├── openbao/              # Process manager, HCL config, lifecycle
│   ├── vault/                # Spaces, secrets, SSH CA, types
│   └── static/               # Console admin SPA (parité CLI 100%)
│       ├── admin.html        # HTML structure + 7 modals
│       ├── css/admin.css     # Design Cloud Temple (dark theme)
│       ├── js/               # 9 modules JS (config, api, app, dashboard, vaults, tokens, policies, activity, pki)
│       └── img/              # logo-cloudtemple.svg
├── tests/
│   ├── README.md             # Guide d'exécution des tests (auditeurs)
│   ├── TEST_CATALOG.md       # Catalogue des tests pour auditeurs
│   ├── test_cli_all.py       # 197 tests CLI parsing (sans serveur)
│   ├── test_cli_live.py      # 79 tests CLI live (serveur réel)
│   ├── test_e2e.py           # 312 tests MCP e2e (15 catégories)
│   ├── test_crypto.py        # 18 tests AES-256-GCM + AAD
│   ├── test_service.py       # 78 tests bas niveau
│   ├── test_integration.py   # Tests pytest
│   └── cli/                  # Tests CLI découpés par groupe (7 fichiers)
└── waf/                      # WAF Caddy + Coraza (OWASP CRS v4)
    ├── Dockerfile            # Multi-stage (xcaddy + CRS v4.7.0)
    ├── Caddyfile             # Reverse proxy + coraza_waf
    └── coraza.conf           # Config Coraza + exceptions MCP

🌐 Écosystème MCP Cloud Temple

ServeurRôlePort
MCP ToolsBoîte à outils (SSH, HTTP, shell):8010
Live MemoryMémoire de travail partagée:8002
Graph MemoryMémoire long terme (graphe):8080
MCP Vault🔐 Coffre-fort à secrets:8030
MCP AgentRuntime d'agents autonomes:8040
MCP MissionOrchestrateur de missions:8020

Licence : Apache 2.0 | Auteur : Cloud Temple | Version : 0.5.1

Ver o original no GitHub

Bom para

Relacionados