CertIndex MCP

официальный

Единственный MCP-сервер для сертификатной прозрачности. Поиск по 2.15B+ TLS-сертификатам, мониторинг доменов на предмет новых выпусков, потоковая передача глобального CT-потока вашему агенту.

GitHub

Что можно делать с Cert Index MCP?

Поиск сертификатов по домену или отпечатку — Найдите TLS-сертификаты с помощью search_certificates по доменному имени или SHA-256 отпечатку.
Получение полных сведений о сертификате — Получите данные PEM, метаданные журнала CT и разобранные поля для конкретного сертификата с помощью get_certificate.
Список всех сертификатов для домена — Получите все сертификаты, когда-либо выпущенные для домена, с помощью get_domain_certificates.
Обнаружение поддоменов из журналов CT — Перечислите поддомены, обнаруженные в сертификатах для заданного домена, с помощью get_subdomains.
Проверка самого последнего сертификата — Получите последний выпущенный сертификат для домена с помощью get_latest_cert.
Поиск сертификатов с истекающим сроком действия — Определите сертификаты, срок действия которых истекает в течение указанного количества дней, с помощью get_expiring_certs.

Документация

certindex-mcp

Сервер MCP (Model Context Protocol), предоставляющий инструменты поиска Certificate Transparency от CertIndex любому MCP-совместимому клиенту (Claude Desktop, MCP Inspector, Continue и т. д.).

CertIndex индексирует весь публичный корпус CT (~5 млн сертификатов, пополняется на ~100 тыс./день). Этот сервер оборачивает публичное REST API CertIndex, чтобы LLM могла задавать вопросы вроде:

«Перечисли все TLS-сертификаты, когда-либо выпущенные для example.com».
«Какие поддомены видел Let's Encrypt для mycompany.io?»
«Покажи сертификаты для api.mycompany.io, истекающие в ближайшие 30 дней».
«Извлеки полный PEM и метаданные CT-лога для SHA-256 <fingerprint>».

Зачем нужен этот репозиторий

Монорепозиторий CertIndex включает MCP-сервер (смонтированный на https://api.ctindex.io/mcp), который напрямую обращается к производственному индексу Postgres. Этот отдельный пакет — тонкая клиентская прослойка: он говорит по MCP с вашим редактором/агентом и перенаправляет каждый вызов инструмента к размещённому REST API CertIndex по HTTPS. Два следствия:

Вам не нужна копия индекса — зарегистрируйтесь для получения бесплатного API-ключа на https://ctindex.io, и готово.
Пакет имеет минимальные зависимости (mcp, httpx, pydantic) — легко аудировать, легко вендорить, без драйверов БД.

Установка

pip install certindex-mcp

Или с помощью uvx для разового использования:

uvx certindex-mcp

Чтобы установить последнюю версию для разработки из исходников:

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

Быстрый старт — Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Перезапустите Claude Desktop. Шесть инструментов CertIndex (search_certificates, get_certificate, get_domain_certificates, get_subdomains, get_latest_cert, get_expiring_certs) появятся в панели инструментов.

Быстрый старт — MCP Inspector

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

Конфигурация

Переменная окружения	По умолчанию	Описание
`CERTINDEX_API_KEY`	(обязательно)	Ваш API-ключ CertIndex. Создайте его на https://ctindex.io/app/keys
`CERTINDEX_BASE_URL`	`https://api.ctindex.io`	Переопределение для собственных развёртываний / staging
`CERTINDEX_TIMEOUT`	`30`	Тайм-аут HTTP на запрос (в секундах)

Безопасность

Валидация ввода, обработка ограничений частоты запросов и наша позиция по цепочке поставок описаны в SECURITY.md. Пожалуйста, сообщайте об уязвимостях на security@ctindex.io, а не создавайте публичные задачи.

Разработка

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

CI работает на Python 3.11 / 3.12 / 3.13.