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

CertIndex MCP ile neler yapabilirsiniz?

Sertifika şeffaflık verilerini ara — search_certificates ile bir alan adı, CN, veren, SAN veya joker durumu için dizinlenmiş TLS sertifikalarını sorgulayın.
Sertifika ayrıntılarını getir — get_certificate ile SHA-256 parmak izini kullanarak tek bir sertifikanın tam PEM ve CT günlük meta verilerini alın.
Alt alan adlarını listele — get_subdomains ile bir alan adı için CT'de görülen benzersiz alt alan adlarını, imleç tabanlı sayfalama ile listeleyin.
Sertifika son kullanma tarihini izle — get_expiring_certs ile bir alan adı için belirtilen gün sayısı içinde sona erecek sertifikaları bulun.
Global taramalar çalıştır — submit_global_sweep ile tüm dizinde CN/SAN desenleri için eşzamansız alt dize taramaları gönderin, ardından get_sweep_results ile sonuçları yoklayın.
API kullanımını kontrol et — get_usage ile katmanınızı, mevcut kullanımınızı, kalan kotanızı ve haklarınızı inceleyin.

Dokümantasyon

certindex-mcp

Bir MCP (Model Context Protocol) sunucusu; CertIndex'in Sertifika Şeffaflığı arama araçlarını MCP uyumlu herhangi bir istemciye (Claude Desktop, MCP Inspector, Continue vb.) sunar.

CertIndex, sertifikaları doğrudan genel Sertifika Şeffaflığı günlüklerinden alır ve bunları kendi dizininden sunar. Geçmişe dönük veri doldurma hâlâ devam ettiğinden, özellikle eski sertifikalar için sonuçlar eksik olabilir. Bu sunucu, genel CertIndex REST API'sini sarar; böylece bir LLM şu tür sorular sorabilir:

"CertIndex'in example.com için dizinlediği TLS sertifikalarını listele."
"Let's Encrypt, mycompany.io için hangi alt alan adlarını görmüş?"
"Önümüzdeki 30 gün içinde sona erecek api.mycompany.io sertifikalarını göster."
"SHA-256 <fingerprint> için tam PEM ve CT günlük meta verilerini getir."

Bu depo neden var

CertIndex monorepo'su, doğrudan üretim Postgres diziniyle konuşan bir MCP sunucusunu (https://api.ctindex.io/mcp konumunda bağlı) bir araya getirir. Bu bağımsız paket ince bir istemci tarafı katmanıdır: düzenleyiciniz/ajanınızla MCP üzerinden konuşur ve her araç çağrısını HTTPS üzerinden barındırılan CertIndex REST API'sine iletir. İki sonuç:

Dizinin bir kopyasına ihtiyacınız yok — https://ctindex.io adresinden ücretsiz bir API anahtarı alın, işiniz biter.
Paketin bağımlılık ayak izi çok küçüktür (mcp, httpx, pydantic) — denetlemesi kolay, satıcıya eklemesi kolay, DB sürücüsü yok.

Kurulum

Sürüm 0.3.0, MCP Python SDK 2.x (mcp>=2,<3) ve Python 3.11+ kullanır. Konsol komutu, ortam değişkenleri ve on araç adı değişmemiştir. SDK 1.x'i koruması gereken uygulamalar için certindex-mcp==0.2.1 kullanın.

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ü kurmak 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. On CertIndex aracı araç tepsisinde görünür.

Araçlar

Barındırılan CertIndex MCP sunucusuyla birebir eşleşen on araç:

Araç	Ne yapar	Önemli parametreler
`search_certificates`	CT dizininde alan adı, CN, veren, SAN, geçerlilik veya joker durumuna göre arama yapar.	`domain`, `cn`, `issuer`, `san`, `expired`, `is_wildcard`, `page`/`limit`
`get_certificate`	SHA-256 parmak izine göre tek bir sertifika getirir.	`sha256`, `include_enrichment`
`get_domain_certificates`	Tam bir alan adı için dizinlenmiş sertifikalar.	`valid_only`, `include_enrichment`, `include_signals` (ücretli planlar), `page`/`limit`
`get_subdomains`	CT'de görülen benzersiz alt alan adlarını numaralandırır.	Ofset (`page`/`limit`) veya anahtar kümesi imleç modu — başlamak için `cursor=""` geçirin, ardından her yanıtın `next_cursor` değerini geri besleyin
`get_latest_cert`	Bir alan adı için en son geçerli sertifika.	`include_enrichment`, `include_signals`, `include_precerts` (ön sertifikaların "en yeni" için rekabet etmesine izin verir)
`get_expiring_certs`	`days` gün içinde sona erecek bir alan adı için sertifikalar.	`days`
`submit_global_sweep`	Tüm dizinin (`POST /v1/sweeps`) alan adı içermeyen, eşzamansız CN/SAN alt dize taraması gönderir.	`cn`/`san_contains` (3+ karakter, en az biri gerekli), `issuer`, `is_wildcard`, `is_precert`, `expired`, `first_seen_`/`not_after_` tarih sınırları, `strict_attribution`, `resume_token` (sonuç sınırının ötesinde devam)
`get_sweep_results`	Bir tarama işini yoklar ve bittiğinde sonuçlarını sayfalar (`GET /v1/sweeps/{id}`).	`sweep_id`, `page`/`limit` (en fazla 1.000)
`get_usage`	Arayanın katmanı, geçerli kullanımı, kalan kotası ve hakları.	—
`get_historical_backfill_status`	Bir alan adı için ücretli derin geçmiş veri doldurmayı kontrol eder / başlatır.	`domain`

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 kendine barındırılan dağıtımlar / hazırlık ortamı için geçersiz kılma
`CERTINDEX_TIMEOUT`	`30`	İstek başına HTTP zaman aşımı (saniye)

Güvenlik

Giriş doğrulama, hız sınırı işleme ve tedarik zinciri duruşumuz SECURITY.md içinde belgelenmiştir. Lütfen güvenlik açıklarını genel sorunlar 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 hem SDK 2.0.0 hem de izin verilen en son 2.x sürümüyle çalışır. Ayrıca derlenmiş tekerleği yeni bir ortama kurar ve gerçek stdio üzerinden başlatma, araç numaralandırma ve çağrıları test eder. HTTP testleri geri döngü üzerinde çalışır; testler üretim kimlik bilgileri gerektirmez.