CertIndex MCP

chính thức

Máy chủ MCP duy nhất về tính minh bạch chứng chỉ. Tìm kiếm hơn 2,15 tỷ chứng chỉ TLS, giám sát tên miền để phát hành mới, truyền trực tiếp luồng dữ liệu CT toàn cầu đến tác nhân của bạn.

GitHub

Bạn có thể làm gì với Cert Index MCP?

Tìm kiếm chứng chỉ theo tên miền hoặc dấu vân tay — Tìm chứng chỉ TLS bằng cách sử dụng search_certificates với tên miền hoặc dấu vân tay SHA-256.
Lấy thông tin chi tiết đầy đủ của chứng chỉ — Truy xuất dữ liệu PEM, siêu dữ liệu nhật ký CT và các trường đã phân tích cho một chứng chỉ cụ thể bằng get_certificate.
Liệt kê tất cả chứng chỉ cho một tên miền — Lấy mọi chứng chỉ từng được cấp cho một tên miền bằng get_domain_certificates.
Khám phá tên miền phụ từ nhật ký CT — Liệt kê các tên miền phụ được quan sát trong chứng chỉ cho một tên miền nhất định qua get_subdomains.
Kiểm tra chứng chỉ gần đây nhất — Truy xuất chứng chỉ mới nhất được cấp cho một tên miền bằng get_latest_cert.
Tìm chứng chỉ sắp hết hạn — Xác định các chứng chỉ hết hạn trong vòng một số ngày được chỉ định bằng get_expiring_certs.

Tài liệu

certindex-mcp

Một máy chủ MCP (Giao thức Ngữ cảnh Mô hình) cung cấp các công cụ tìm kiếm Minh bạch Chứng chỉ của CertIndex cho bất kỳ máy khách tương thích MCP nào (Claude Desktop, MCP Inspector, Continue, v.v.).

CertIndex lập chỉ mục toàn bộ kho CT công khai (~5 triệu chứng chỉ, tăng trưởng ~100 nghìn/ngày). Máy chủ này bao bọc API REST công khai của CertIndex để một LLM có thể đặt các câu hỏi như:

"Liệt kê mọi chứng chỉ TLS từng được cấp cho example.com."
"Let's Encrypt đã thấy những tên miền phụ nào cho mycompany.io?"
"Hiển thị các chứng chỉ sắp hết hạn trong 30 ngày tới cho api.mycompany.io."
"Lấy toàn bộ PEM và siêu dữ liệu nhật ký CT cho SHA-256 <fingerprint>."

Tại sao repo này tồn tại

Monorepo CertIndex đi kèm một máy chủ MCP (được gắn tại https://api.ctindex.io/mcp) giao tiếp trực tiếp với chỉ mục Postgres sản xuất. Gói độc lập này là một lớp trung gian mỏng phía máy khách: nó giao tiếp MCP với trình soạn thảo/tác nhân của bạn và chuyển tiếp mọi lệnh gọi công cụ đến API REST được lưu trữ của CertIndex qua HTTPS. Hai hệ quả:

Bạn không cần một bản sao của chỉ mục — đăng ký khóa API miễn phí tại https://ctindex.io là xong.
Gói có phạm vi phụ thuộc nhỏ (mcp, httpx, pydantic) — dễ kiểm tra, dễ đóng gói, không cần trình điều khiển DB.

Cài đặt

pip install certindex-mcp

Hoặc với uvx để sử dụng một lần:

uvx certindex-mcp

Để cài đặt phiên bản phát triển mới nhất từ mã nguồn thay thế:

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

Bắt đầu nhanh — Claude Desktop

Thêm vào ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) hoặc %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Khởi động lại Claude Desktop. Sáu công cụ CertIndex (search_certificates, get_certificate, get_domain_certificates, get_subdomains, get_latest_cert, get_expiring_certs) sẽ xuất hiện trong khay công cụ.

Bắt đầu nhanh — MCP Inspector

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

Cấu hình

Biến môi trường	Mặc định	Mô tả
`CERTINDEX_API_KEY`	(bắt buộc)	Khóa API CertIndex của bạn. Tạo một khóa tại https://ctindex.io/app/keys
`CERTINDEX_BASE_URL`	`https://api.ctindex.io`	Ghi đè cho các triển khai tự lưu trữ / staging
`CERTINDEX_TIMEOUT`	`30`	Thời gian chờ HTTP cho mỗi yêu cầu (giây)

Bảo mật

Xác thực đầu vào, xử lý giới hạn tốc độ và tình trạng chuỗi cung ứng của chúng tôi được ghi lại trong SECURITY.md. Vui lòng báo cáo các lỗ hổng tới security@ctindex.io thay vì nộp các vấn đề công khai.

Phát triển

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

CI chạy trên Python 3.11 / 3.12 / 3.13.