CertIndex MCP

resmi

Satu-satunya server MCP transparansi sertifikat. Cari 2,15 miliar+ sertifikat TLS, pantau domain untuk penerbitan baru, alirkan data langsung CT global ke agen Anda.

GitHub

Apa yang bisa Anda lakukan dengan Cert Index MCP?

Cari sertifikat berdasarkan domain atau sidik jari — Temukan sertifikat TLS menggunakan search_certificates dengan nama domain atau sidik jari SHA-256.
Ambil detail sertifikat lengkap — Ambil data PEM, metadata log CT, dan kolom yang telah diurai untuk sertifikat tertentu dengan get_certificate.
Daftar semua sertifikat untuk suatu domain — Dapatkan setiap sertifikat yang pernah diterbitkan untuk suatu domain menggunakan get_domain_certificates.
Temukan subdomain dari log CT — Hitung subdomain yang diamati dalam sertifikat untuk domain tertentu melalui get_subdomains.
Periksa sertifikat terbaru — Ambil sertifikat terbaru yang diterbitkan untuk suatu domain dengan get_latest_cert.
Temukan sertifikat yang mendekati masa berlaku — Identifikasi sertifikat yang kedaluwarsa dalam jumlah hari tertentu menggunakan get_expiring_certs.

Dokumentasi

certindex-mcp

Sebuah server MCP (Model Context Protocol) yang mengekspos alat pencarian Certificate Transparency CertIndex ke klien yang kompatibel dengan MCP (Claude Desktop, MCP Inspector, Continue, dll.).

CertIndex mengindeks korpus CT publik lengkap (~5 juta sertifikat, bertambah ~100 ribu/hari). Server ini membungkus REST API publik CertIndex sehingga LLM dapat mengajukan pertanyaan seperti:

"Daftarkan setiap sertifikat TLS yang pernah diterbitkan untuk example.com."
"Subdomain apa yang telah dilihat Let's Encrypt untuk mycompany.io?"
"Tunjukkan sertifikat yang kedaluwarsa dalam 30 hari ke depan untuk api.mycompany.io."
"Ambil metadata log PEM dan CT lengkap untuk SHA-256 <fingerprint>."

Mengapa repositori ini ada

Monorepo CertIndex menggabungkan server MCP (dipasang di https://api.ctindex.io/mcp) yang berbicara langsung ke indeks Postgres produksi. Paket mandiri ini adalah shim sisi klien tipis: ia berbicara MCP ke editor/agen Anda dan meneruskan setiap panggilan alat ke REST API CertIndex yang dihosting melalui HTTPS. Dua konsekuensi:

Anda tidak memerlukan salinan indeks — daftar untuk kunci API gratis di https://ctindex.io dan selesai.
Paket ini memiliki jejak dependensi yang kecil (mcp, httpx, pydantic) — mudah diaudit, mudah divendor, tanpa driver DB.

Instalasi

pip install certindex-mcp

Atau dengan uvx untuk penggunaan satu kali:

uvx certindex-mcp

Untuk menginstal versi pengembangan terbaru dari sumber:

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

Mulai Cepat — Claude Desktop

Tambahkan ke ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) atau %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Mulai ulang Claude Desktop. Enam alat CertIndex (search_certificates, get_certificate, get_domain_certificates, get_subdomains, get_latest_cert, get_expiring_certs) muncul di baki alat.

Mulai Cepat — MCP Inspector

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

Konfigurasi

Var lingkungan	Default	Deskripsi
`CERTINDEX_API_KEY`	(wajib)	Kunci API CertIndex Anda. Buat satu di https://ctindex.io/app/keys
`CERTINDEX_BASE_URL`	`https://api.ctindex.io`	Timpa untuk penerapan self-hosted / staging
`CERTINDEX_TIMEOUT`	`30`	Batas waktu HTTP per permintaan (detik)

Keamanan

Validasi input, penanganan batas laju, dan postur rantai pasokan kami didokumentasikan di SECURITY.md. Harap laporkan kerentanan ke security@ctindex.io daripada mengajukan isu publik.

Pengembangan

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

CI berjalan pada Python 3.11 / 3.12 / 3.13.