CertIndex MCP

resmi

Sertifika şeffaflığı alanındaki tek MCP sunucusu. 2,15 milyar+ TLS sertifikasını arayın, yeni düzenlemeler için alan adlarını izleyin, küresel CT veri akışını aracınıza aktarın.

GitHub

Cert Index MCP ile neler yapabilirsiniz?

Sertifikaları alan adı veya parmak izine göre arayın — search_certificates ile bir alan adı veya SHA-256 parmak izi kullanarak TLS sertifikalarını bulun.
Tam sertifika ayrıntılarını alın — Belirli bir sertifika için get_certificate ile PEM verilerini, CT günlük meta verilerini ve ayrıştırılmış alanları getirin.
Bir alan adı için tüm sertifikaları listeleyin — get_domain_certificates kullanarak bir alan adı için şimdiye kadar yayınlanmış tüm sertifikaları alın.
CT günlüklerinden alt alan adlarını keşfedin — get_subdomains aracılığıyla belirli bir alan adı için sertifikalarda gözlemlenen alt alan adlarını sıralayın.
En son sertifikayı kontrol edin — get_latest_cert ile bir alan adı için yayınlanan en son sertifikayı alın.
Süresi yaklaşan sertifikaları bulun — get_expiring_certs kullanarak belirtilen gün sayısı içinde süresi dolacak sertifikaları belirleyin.

Dokümantasyon

certindex-mcp

CertIndex'in Sertifika Şeffaflığı arama araçlarını, MCP uyumlu herhangi bir istemciye (Claude Desktop, MCP Inspector, Continue vb.) sunan bir MCP (Model Bağlam Protokolü) sunucusu.

CertIndex, tüm genel CT külliyatını (~5 milyon sertifika, günde ~100 bin artış) indeksler. Bu sunucu, genel CertIndex REST API'sini sarmalayarak bir LLM'nin şu tür sorular sormasına olanak tanır:

"example.com için şimdiye kadar verilmiş tüm TLS sertifikalarını listele."
"Let's Encrypt, mycompany.io için hangi alt alan adlarını gördü?"
"api.mycompany.io için önümüzdeki 30 gün içinde süresi dolacak sertifikaları göster."
"SHA-256 <fingerprint> için tam PEM ve CT günlük meta verilerini al."

Bu repo neden var

CertIndex mono-reposu, doğrudan üretim Postgres indeksiyle konuşan bir MCP sunucusu (https://api.ctindex.io/mcp yolunda bağlanır) içerir. Bu bağımsız paket, ince bir istemci tarafı aracıdır: düzenleyicinize/aracınıza MCP konuşur ve her araç çağrısını HTTPS üzerinden barındırılan CertIndex REST API'sine iletir. Bunun iki sonucu:

İndeksin bir kopyasına ihtiyacınız yok — https://ctindex.io adresinden ücretsiz bir API anahtarı alın, hepsi bu.
Paketin bağımlılık ayak izi küçüktür (mcp, httpx, pydantic) — denetlemesi kolay, satıcıya eklemesi kolay, veritabanı sürücüsü yok.

Kurulum

pip install certindex-mcp

Veya tek seferlik kullanım için uvx ile:

uvx certindex-mcp

Bunun yerine kaynaktan en son geliştirme sürümünü yüklemek için:

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

Hızlı Başlangıç — Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya %APPDATA%\Claude\claude_desktop_config.json (Windows) dosyasına ekleyin:

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

Claude Desktop'ı yeniden başlatın. Altı CertIndex aracı (search_certificates, get_certificate, get_domain_certificates, get_subdomains, get_latest_cert, get_expiring_certs) araç tepsisinde görünür.

Hızlı Başlangıç — MCP Inspector

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

Yapılandırma

Ortam değişkeni	Varsayılan	Açıklama
`CERTINDEX_API_KEY`	(gerekli)	CertIndex API anahtarınız. https://ctindex.io/app/keys adresinden bir tane oluşturun
`CERTINDEX_BASE_URL`	`https://api.ctindex.io`	Kendi barındırdığınız dağıtımlar / hazırlık için geçersiz kılma
`CERTINDEX_TIMEOUT`	`30`	İstek başına HTTP zaman aşımı (saniye)

Güvenlik

Girdi doğrulama, hız sınırı yönetimi ve tedarik zinciri duruşumuz SECURITY.md dosyasında belgelenmiştir. Lütfen güvenlik açıklarını herkese açık konular açmak yerine security@ctindex.io adresine bildirin.

Geliştirme

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

CI, Python 3.11 / 3.12 / 3.13 üzerinde çalışır.