CertIndex MCP

ทางการ

The only certificate-transparency MCP server. Search 2.15B+ TLS certificates, monitor domains for new issuance, stream the global CT firehose to your agent.

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,000 ใบต่อวัน) เซิร์ฟเวอร์นี้ครอบคลุม REST API สาธารณะของ CertIndex เพื่อให้ LLM สามารถถามคำถามเช่น:

"แสดงรายการใบรับรอง TLS ทั้งหมดที่เคยออกให้สำหรับ example.com"
"Let's Encrypt เห็นซับโดเมนอะไรบ้างสำหรับ mycompany.io"
"แสดงใบรับรองที่จะหมดอายุใน 30 วันข้างหน้าสำหรับ api.mycompany.io"
"ดึง PEM แบบเต็มและข้อมูลเมตาของ CT log สำหรับ SHA-256 <fingerprint>"

เหตุใดจึงมี repo นี้

CertIndex monorepo รวมเซิร์ฟเวอร์ 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