CertIndex MCP

officiel

Le seul serveur MCP de transparence des certificats. Recherchez parmi plus de 2,15 milliards de certificats TLS, surveillez les domaines pour les nouvelles émissions, diffusez le flux global CT vers votre agent.

GitHub

Que pouvez-vous faire avec Cert Index MCP ?

Rechercher des certificats par domaine ou empreinte — Trouvez des certificats TLS en utilisant search_certificates avec un nom de domaine ou une empreinte SHA-256.
Récupérer les détails complets d’un certificat — Obtenez les données PEM, les métadonnées des logs CT et les champs analysés pour un certificat spécifique avec get_certificate.
Lister tous les certificats pour un domaine — Obtenez tous les certificats jamais émis pour un domaine en utilisant get_domain_certificates.
Découvrir les sous-domaines à partir des logs CT — Énumérez les sous-domaines observés dans les certificats pour un domaine donné via get_subdomains.
Vérifier le certificat le plus récent — Récupérez le dernier certificat émis pour un domaine avec get_latest_cert.
Trouver les certificats proches de l’expiration — Identifiez les certificats expirant dans un nombre de jours spécifié en utilisant get_expiring_certs.

Documentation

certindex-mcp

Un serveur MCP (Model Context Protocol) qui expose les outils de recherche de transparence des certificats de CertIndex à tout client compatible MCP (Claude Desktop, l'inspecteur MCP, Continue, etc.).

CertIndex indexe l'intégralité du corpus CT public (~5 M de certificats, en croissance d'environ 100 k/jour). Ce serveur enveloppe l'API REST publique de CertIndex afin qu'un LLM puisse poser des questions telles que :

« Lister tous les certificats TLS jamais émis pour example.com. »
« Quels sous-domaines Let's Encrypt a-t-il vus pour mycompany.io ? »
« Montre-moi les certificats expirant dans les 30 prochains jours pour api.mycompany.io. »
« Récupère le PEM complet et les métadonnées du journal CT pour le SHA-256 <fingerprint>. »

Pourquoi ce dépôt existe

Le monorepo CertIndex regroupe un serveur MCP (monté sur https://api.ctindex.io/mcp) qui dialogue directement avec l'index Postgres de production. Ce paquet autonome est une fine couche côté client : il parle MCP à votre éditeur/agent et transmet chaque appel d'outil à l'API REST CertIndex hébergée via HTTPS. Deux conséquences :

Vous n'avez pas besoin d'une copie de l'index — inscrivez-vous pour obtenir une clé API gratuite sur https://ctindex.io et c'est terminé.
Le paquet a une empreinte de dépendances minuscule (mcp, httpx, pydantic) — facile à auditer, facile à intégrer, sans pilotes de base de données.

Installation

pip install certindex-mcp

Ou avec uvx pour une utilisation ponctuelle :

uvx certindex-mcp

Pour installer la dernière version de développement depuis les sources :

pip install git+https://github.com/certindex/certindex-mcp

Démarrage rapide — Claude Desktop

Ajoutez à ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :

{
  "mcpServers": {
    "certindex": {
      "command": "uvx",
      "args": ["certindex-mcp"],
      "env": {
        "CERTINDEX_API_KEY": "ctx_live_..."
      }
    }
  }
}

Redémarrez Claude Desktop. Les six outils CertIndex (search_certificates, get_certificate, get_domain_certificates, get_subdomains, get_latest_cert, get_expiring_certs) apparaissent dans la barre d'outils.

Démarrage rapide — Inspecteur MCP

export CERTINDEX_API_KEY=ctx_live_...
npx @modelcontextprotocol/inspector uvx certindex-mcp

Configuration

Variable d'env	Par défaut	Description
`CERTINDEX_API_KEY`	(obligatoire)	Votre clé API CertIndex. Créez-en une sur https://ctindex.io/app/keys
`CERTINDEX_BASE_URL`	`https://api.ctindex.io`	Surcharge pour les déploiements auto-hébergés / staging
`CERTINDEX_TIMEOUT`	`30`	Délai d'expiration HTTP par requête (secondes)

Sécurité

La validation des entrées, la gestion des limites de débit et notre posture de chaîne d'approvisionnement sont documentées dans SECURITY.md. Veuillez signaler les vulnérabilités à security@ctindex.io plutôt que de créer des tickets publics.

Développement

git clone https://github.com/certindex/certindex-mcp
cd certindex-mcp
pip install -e ".[dev]"
pytest

La CI s'exécute sur Python 3.11 / 3.12 / 3.13.