CertIndex MCP

certindex-mcp

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

CertIndex menyerap sertifikat secara langsung dari log Certificate Transparency publik dan menyajikannya dari indeksnya sendiri. Pengisian data historis masih dalam proses, sehingga hasil, terutama untuk sertifikat yang lebih lama, mungkin tidak lengkap. Server ini membungkus REST API publik CertIndex sehingga LLM dapat mengajukan pertanyaan seperti:

• "Daftarkan sertifikat TLS yang telah diindeks CertIndex untuk example.com."
• "Subdomain apa saja yang telah dilihat Let's Encrypt untuk mycompany.io?"
• "Tampilkan sertifikat yang kedaluwarsa dalam 30 hari ke depan untuk api.mycompany.io."
• "Ambil PEM lengkap dan metadata log CT 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 yang tipis: ia berbicara MCP ke editor/agen Anda dan meneruskan setiap panggilan alat ke REST API CertIndex yang di-hosting melalui HTTPS. Dua konsekuensi:

1. Anda tidak perlu salinan indeks — daftar untuk kunci API gratis di https://ctindex.io dan selesai.
2. Paket ini memiliki jejak dependensi yang kecil (mcp, httpx, pydantic) — mudah diaudit, mudah di-vendor, tanpa driver basis data.

Instalasi

Versi 0.3.0 menggunakan MCP Python SDK 2.x (mcp>=2,<3) dan Python 3.11+. Perintah konsol, variabel lingkungan, dan sepuluh nama alat tidak berubah. Untuk aplikasi yang harus mempertahankan SDK 1.x, gunakan certindex-mcp==0.2.1.

pip install certindex-mcp

Atau dengan uvx untuk penggunaan sekali jalan:

uvx certindex-mcp

Untuk menginstal versi pengembangan terbaru dari sumber sebagai gantinya:

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

Panduan 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. Sepuluh alat CertIndex muncul di baki alat.

Alat

Sepuluh alat, cocok 1:1 dengan server MCP CertIndex yang di-hosting:

Alat	Fungsinya	Parameter penting
search_certificates	Cari indeks CT berdasarkan domain, CN, penerbit, SAN, masa berlaku, atau status wildcard.	domain, cn, issuer, san, expired, is_wildcard, page/limit
get_certificate	Ambil satu sertifikat berdasarkan sidik jari SHA-256.	sha256, include_enrichment
get_domain_certificates	Sertifikat yang diindeks untuk domain yang tepat.	valid_only, include_enrichment, include_signals (paket berbayar), page/limit
get_subdomains	Sebutkan subdomain unik yang terlihat di CT.	Offset (page/limit) atau mode kursor keyset — berikan cursor="" untuk memulai, lalu umpan balik next_cursor dari setiap respons
get_latest_cert	Sertifikat valid terbaru saat ini untuk sebuah domain.	include_enrichment, include_signals, include_precerts (izinkan presertifikat bersaing untuk "terbaru")
get_expiring_certs	Sertifikat untuk domain yang kedaluwarsa dalam days hari.	days
submit_global_sweep	Kirim sapuan substring CN/SAN asinkron tanpa domain di seluruh indeks (POST /v1/sweeps).	cn/san_contains (3+ karakter, setidaknya satu wajib), issuer, is_wildcard, is_precert, expired, first_seen_*/not_after_* batas tanggal, strict_attribution, resume_token (kelanjutan melewati batas hasil)
get_sweep_results	Poll pekerjaan sapuan dan paginasi hasilnya saat selesai (GET /v1/sweeps/{id}).	sweep_id, page/limit (hingga 1.000)
get_usage	Tingkat pemanggil, penggunaan saat ini, kuota tersisa, dan hak akses.	—
get_historical_backfill_status	Periksa / mulai pengisian data riwayat mendalam berbayar untuk sebuah domain.	domain

Panduan cepat — MCP Inspector

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

Konfigurasi

Variabel 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	Penimpaan untuk penyebaran yang di-host sendiri / staging
CERTINDEX_TIMEOUT	30	Batas waktu HTTP per permintaan (detik)

Keamanan

Validasi input, penanganan batas kecepatan, dan postur rantai pasokan kami didokumentasikan di SECURITY.md. Harap laporkan kerentanan ke security@ctindex.io daripada mengajukan masalah 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 dengan SDK 2.0.0 dan rilis 2.x terbaru yang diizinkan. CI juga menginstal wheel yang dibangun ke lingkungan baru dan menguji inisialisasi, enumerasi alat, dan panggilan melalui stdio nyata. Fixture HTTP berjalan di loopback; pengujian tidak memerlukan kredensial produksi.

Lisensi

MIT © Kontributor CertIndex.