CertIndex MCP

公式

唯一の証明書透過性MCPサーバー。21.5億以上のTLS証明書を検索し、ドメインの新規発行を監視し、グローバルCTファイアホースをエージェントにストリーミングします。

GitHub

Cert Index MCPで何ができますか？

  • ドメインまたはフィンガープリントで証明書を検索 — search_certificatesを使用して、ドメイン名またはSHA-256フィンガープリントでTLS証明書を検索します。
  • 証明書の詳細を完全に取得 — get_certificateで、特定の証明書のPEMデータ、CTログメタデータ、解析済みフィールドを取得します。
  • ドメインの全証明書を一覧表示 — get_domain_certificatesを使用して、ドメインに対して発行されたすべての証明書を取得します。
  • CTログからサブドメインを発見 — get_subdomainsを介して、指定されたドメインの証明書で観測されたサブドメインを列挙します。
  • 最新の証明書を確認 — get_latest_certで、ドメインに対して最新に発行された証明書を取得します。
  • 有効期限が近い証明書を検索 — get_expiring_certsを使用して、指定された日数以内に期限切れとなる証明書を特定します。

ドキュメント

certindex-mcp

CI PyPI License: MIT

CertIndex の Certificate Transparency 検索ツールを、あらゆる MCP 互換クライアント（Claude Desktop、MCP Inspector、Continue など）に公開する MCP（Model Context Protocol）サーバーです。

CertIndex は公開 CT コーパス全体（約 500 万証明書、1 日あたり約 10 万増加）をインデックス化しています。このサーバーは公開 CertIndex REST API をラップし、LLM が次のような質問を行えるようにします。

  • 「example.com に対して発行されたすべての TLS 証明書を一覧表示して。」
  • 「Let's Encrypt が mycompany.io に対して確認したサブドメインは？」
  • 「api.mycompany.io の今後 30 日以内に期限切れとなる証明書を表示して。」
  • 「SHA-256 <fingerprint> の完全な PEM と CT ログメタデータを取得して。」

このリポジトリが存在する理由

CertIndex モノレポには、本番 Postgres インデックスと直接通信する MCP サーバー（https://api.ctindex.io/mcp にマウント）がバンドルされています。このスタンドアロンパッケージは、シンなクライアントサイドのシムです。エディタ/エージェントに対して MCP で通信し、すべてのツール呼び出しを HTTPS 経由でホストされた CertIndex REST API に転送します。これにより、次の 2 つの結果が得られます。

  1. インデックスのコピーは不要です。https://ctindex.io で無料の API キーにサインアップするだけで完了します。
  2. パッケージの依存関係はごくわずか（mcp、httpx、pydantic）で、監査やベンダー化が容易であり、DB ドライバーも不要です。

インストール

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 を再起動します。6 つの 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(必須)CertIndex API キー。https://ctindex.io/app/keys で発行してください。
CERTINDEX_BASE_URLhttps://api.ctindex.ioセルフホストデプロイ/ステージング用の上書き
CERTINDEX_TIMEOUT30リクエストごとの HTTP タイムアウト（秒）

セキュリティ

入力検証、レート制限処理、およびサプライチェーンの体制については、SECURITY.md に記載されています。脆弱性は公開 Issue として報告するのではなく、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 で実行されます。

ライセンス

MIT © CertIndex contributors.