security-recipes.ai

CVE를 검색하세요. AI 에이전트로 취약점을 해결하세요. 출처가 있는 사실은 출처를 유지하고, 해결 범위는 제한되며, 모든 계획에는 검증, 롤백, 중지 조건이 포함됩니다 — 라이브 사이트의 계약이자 이 저장소의 계약입니다.

security-recipes.ai는 출처가 있는 CVE 인텔리전스와 증거 기반의 취약점 해결을 위한 Eleventy 사이트로, AI 에이전트가 배포나 프로덕션 권한을 상속하지 않고도 사용할 수 있습니다.

이 프로젝트는 의도적으로 범위를 좁게 잡았습니다:

• 완전한 순환형 Medium/High/Critical CVE 데이터베이스,

• 증거로 검증된 정식 CVE 해결 레코드,

• 실용적인 보안 해결 레시피,

• 프롬프트 및 규칙 파일 예시,

• 에이전트 설정 가이드,

• MCP 통합 패턴,

• 레시피 검색 및 승인된 업스트림 MCP 컨텍스트를 위한 선택적 읽기 전용 MCP 서버,

• 이 지침을 토글 가능한 CI 상태 점검으로 전환하는 재사용 가능한 GitHub Action.

이것은 스캐너, 티켓 시스템, SOAR 플랫폼, 배포 도구, 또는 맞춤형 보안 툴킷이 아닙니다. 기존 보안 도구가 결과를 생성해야 하며, 이 사이트는 에이전트가 올바른 해결 컨텍스트를 사용하고 적절한 시점에 중지하도록 돕습니다.

정확한 취약점을 찾으려면 라이브 CVE 데이터베이스에서 시작하거나, 증거에서 패치까지의 워크플로우를 보려면 AI 취약점 해결 플레이북을 참조하세요. 에이전트별 가이드는 Codex, Claude Code, Cursor, GitHub Copilot, Devin, Shiba Studio, Hermes Desktop, OpenClaw를 다룹니다. 시각적 가이드는 소스 검증과 검색 발견에서 제한된 계획, 증명, 롤백, 인간 검토까지의 전체 경로를 보여줍니다. 에이전트 시스템의 ID, 도구, 커넥터, 컨텍스트, 메모리, 런타임, 복구 제어를 보호하는 별개의 문제에 대해서는 AI 에이전트 보안을 사용하세요.

현재 제품 및 워크플로우

검증된 검색 발견

전체 카탈로그는 검색 가능한 상태로 유지되지만, 공개 정식 CVE 페이지는 검토되거나 증거로 검증된 레코드로 제한됩니다. 해당 페이지에는 고유한 검색 메타데이터, 서버 렌더링 핵심 사실 및 영향받는 버전 증거, 하나의 해결 권위(안정적인 검토 지침 우선, 그렇지 않으면 완전한 소스 연결 AI 강화), 짧은 승인 게이트 AI 구현 프롬프트, 정식 URL, 브레드크럼, Article/TechArticle 구조화 데이터가 포함됩니다. CVE 데이터베이스는 카탈로그를 Dataset으로 설명하고, 해결 기둥은 보이는 7단계 워크플로우를 HowTo로 노출합니다. 연도별 CVE 사이트맵에는 색인 가능한 정식 경로만 포함되며, 사이트맵 일치, 정식 소유권, 크롤링 도달 가능성, 메타데이터 제한, 동일 출처 링크가 어긋나면 빌드가 실패합니다.

대량 템플릿 레시피 하위 페이지에도 색인 가능성이 부여되지 않습니다. 72개의 개발 코드 위생 레시피와 39개의 생성된 규정 준수 프레임워크 레시피는 공통 방법을 공유하는 동안 noindex,follow로 정식 허브에서 탐색 가능하게 유지됩니다. 제한된 렌더링 본문 유사성 게이트는 하위 페이지의 증거, 예시, 테스트가 실질적으로 구별될 때까지 사이트맵에 다시 진입하지 못하게 합니다. 허브는 색인 가능한 상태로 유지되며 공유 발견 컨텍스트를 전달합니다.

SEO 관련 릴리스 후에는 사이트맵 제출 또는 URL 검사 전에 공개 개정판이 병합 커밋과 일치해야 합니다. Caddy 배포 가이드는 DNS 검증된 Search Console 핸드오프, 우선 순위 라이브 URL 검사, 사이트맵 제출, 색인 요청, 쿼리 모니터링을 문서화합니다. 제출은 발견 힌트일 뿐이며 색인 또는 특정 순위를 보장하지 않습니다.

해결 기둥은 또한 brace-expansion의 CVE-2026-13149에 대한 공개 저장소 예시를 기록합니다. 이는 의존성 전용 변경을 검토된 풀 리퀘스트, 테스트, 권고 증거, 복구 경로와 연결하면서 동일한 PR의 관련 없는 Fail2Ban 작업을 명시적으로 분리합니다.

Related MCP server: CVE Intelligence MCP Server

이 프로젝트의 목적

AI 코딩 에이전트는 작업이 제한될 때 보안 결과를 해결하는 데 도움이 될 수 있습니다: 하나의 결과, 하나의 레시피, 하나의 검토된 출력.

security-recipes.ai는 팀이 다음 질문에 답하도록 돕습니다:

• 이 결과에 맞는 레시피는 무엇인가?

• 에이전트가 사용해야 할 프롬프트는 무엇인가?

• Copilot, Claude, Cursor, Codex, Devin에 대한 지침을 어디에 두어야 하는가?

• 에이전트가 권고, 스캐너, 저장소, 런북 컨텍스트를 위해 어떤 MCP 서버를 읽어야 하는가?

• 검토자가 신뢰하기 전에 PR 또는 트라이지 노트에 무엇이 포함되어야 하는가?

제공되는 것

• Eleventy 문서 사이트 (빠른 정적 빌드, Go 툴체인 불필요).

• CVE 우선 관측소 홈 페이지 및 데이터 우선 CVE 데이터베이스.

• 의존성, SAST, 민감 데이터, 기본 이미지, CVE, 기본 강화 해결을 위한 레시피 허브.

• 에이전트가 패치하기 전에 권고 신호를 라우팅하기 위한 CVE 인텔리전스 수집 정책, 프롬프트, 픽스처, 평가기.

• 무결성 검증된 NVD JSON 2.0 피드, CISA KEV 메타데이터, 모든 적용 가능한 검증된 해결 아키타입으로 구성된 완전한 순환형 10년 Medium/High/Critical CVE 카탈로그. 검토된 stable Markdown 페이지만이 보수적인 기준선을 재정의합니다.

• 무결성 해시된 검색 허용 목록으로, 검토된 stable Markdown 또는 결정적 레시피 준비 증거 계약을 통과하는 AI 강화에 대해서만 정식 CVE 페이지를 게시합니다. 레코드가 검색 색인에 적합하지 않아도 전체 데이터베이스는 검색 가능합니다.

• 모든 카탈로그 CVE에 대한 버전 관리된 7단계 에이전트 변경 계약: 발견, 평가, 완화, 해결, 검증, 롤백, 트라이지. 각 작업은 패치나 고정 버전을 추측하지 않고 가능한 파일 대상, 변경 및 승인 경계, 필수 증거, 출력, 실패 동작을 선언합니다.

• 라이선스가 있는 제어 텍스트를 재생산하지 않고 39개의 보안, 개인정보 보호, 보증, 복원력, 소프트웨어 공급망 프레임워크를 포괄하는 구조화된 규정 준수 라이브러리. 프레임워크 허브가 검색 표면이며, 템플릿 하위 평가는 차별화될 때까지 noindex,follow로 유지됩니다.

• 교차 언어 및 생태계별 감사, 해결, 검증, 중지 조건 워크플로우를 다루는 72개 레시피 코드 위생 라이브러리. 개발 하위 페이지는 본문이 생성된 템플릿을 공유하는 동안 noindex,follow로 유지됩니다.

• 기존 프롬프트 컬렉션이 보존된 레시피.

• GitHub Copilot, Claude, Cursor, Codex, Devin용 에이전트 설정 가이드.

• 공개 및 조직 승인 보안 데이터 소스에 대한 MCP 통합 지침.

• 레시피 검색, 검색, 옵트인 업스트림 MCP 컨텍스트를 위한 mcp_server.py의 선택적 읽기 전용 FastMCP 서버.

• 로컬 또는 드롭릿 호스팅을 위한 Docker 및 Docker Compose 구성.

• 사이트 유지 관리, 검증, 가져오기, 배포를 위한 도우미 스크립트.

저장소 맵

핵심 콘텐츠 영역

• CVE 데이터베이스: 소스 기반 CVE 인텔리전스, 영향 버전 증거 및 표준 수정 기록.

• AI 취약점 수정: 단일 발견 항목에서 검토된 패치 또는 트리아지 노트까지 이어지는 증거 기반 플레이북.

• AI 에이전트 보안: AI 에이전트 시스템 자체에 대한 위협 모델링, 프로덕션 기준, 소스 경계, 제어 라우팅, 증거 및 사고 대비.

• 빠른 시작: 단일 발견 항목에서 검토된 PR 또는 트리아지 노트까지.

• AI 에이전트 비교: Copilot, Claude Code, Cursor, Codex 및 Devin에 대한 검증된 운영 모드, 네이티브 지침, 예상 산출물, 사전 요구 사항 및 검토 게이트.

• 레시피: 재사용 가능한 프롬프트, 지침, 규칙, 스킬 및 검토 체크리스트.

• MCP 통합: 보안 컨텍스트를 안전하게 연결하는 방법.

• 시각적 가이드: 다섯 개의 다이어그램으로 보는 적격 검색-발견, CVE-계획, 증명, 롤백, 검토 및 읽기 전용 MCP 흐름.

• 문서: 사이트 사용법, 에이전트 소비 패턴 및 기여 지침.

Python 수정 도구

Python 제품군은 문서의 선택적 실행 동반자입니다. 이 도구는 제한된 작업 공간을 검사하고, 75개의 수정 플레이북 중 하나를 선택하고, 지속 가능한 실행 패킷을 생성하고, 무결성 해시 증거를 기록하고, 에이전트 또는 검토자 인계 전에 패킷을 검증할 수 있습니다. 로컬에서 보수적으로 작동합니다: 코드를 병합하거나, 변경 사항을 배포하거나, 외부 시스템을 자체적으로 호출하지 않습니다.

python scripts/security_recipes_remediation_suite.py playbook list
python scripts/security_recipes_remediation_suite.py playbook inspect \
  --playbook vulnerable-dependencies --workspace .
python scripts/security_recipes_remediation_suite.py playbook start \
  --playbook vulnerable-dependencies --workspace . \
  --finding finding.json --run-dir .security-recipes/runs/dependency-fix
python scripts/security_recipes_remediation_suite.py playbook verify \
  --run-dir .security-recipes/runs/dependency-fix

저장소에는 더 풍부한 증거 패킷이나 런타임 정책 결정이 필요한 플레이북을 위한 도메인별 생성기 및 평가기도 포함되어 있습니다. 사이트와 JSON 레지스트리는 Python 없이도 유용합니다. 이 도구들은 동일한 워크플로 계약을 CI, 오케스트레이터 및 승인된 코딩 에이전트가 직접 실행할 수 있게 만듭니다.

알아두면 유용한 배포 헬퍼:

• scripts/setup_digitalocean_droplet.sh: Docker, 호스트 강화 및 선택적 Caddy 관리 HTTPS를 포함한 Ubuntu droplet 부트스트랩.

• scripts/configure_nginx_letsencrypt.sh: Caddy 대신 nginx에서 Let's Encrypt를 사용하려는 팀을 위한 호스트 nginx 리버스 프록시 설정.

• README.nginx-letsencrypt.md: nginx 배포 경로에 대한 운영자 중심 워크스루.

권장 운영 모델:

1. 기존 SCA, SAST, 시크릿, CI, 클라우드 및 티켓팅 시스템이 발견 항목을 생성하도록 합니다.

2. 일치하는 security-recipes.ai 레시피와 프롬프트를 연결합니다.

3. 에이전트가 발견 항목에 필요한 파일과 MCP 컨텍스트만 읽도록 합니다.

4. 병합 전에 테스트와 사람의 검토를 요구합니다.

5. 광범위한 자동화, 쓰기 액세스 및 배포는 첫 번째 루프 밖에 둡니다.

가이드북 및 실행 도구

이 사이트는 수정 작업을 위한 가이드북입니다: 레시피, 프롬프트, 에이전트 설정, MCP/API 통합 노트 및 검토 패턴. 런타임 자동화는 사이트 호스팅 챗봇이 아닌 사용자의 승인된 에이전트 호스트, CI 시스템, 티켓팅 워크플로 또는 스캐너 플랫폼에 속합니다.

scripts/, tools/ 및 mcp_server.py의 Python 도구는 유지관리자와 셀프 호스터를 위해 플레이북 실행 패킷, 증거 검증, 도메인별 평가 및 생성, 검증, 자문 가져오기, 레시피 검색 및 선택적 읽기 전용 MCP 액세스를 지원합니다.

선택적 MCP 서버

MCP 서버는 기본적으로 읽기 전용입니다. 기본 역할은 MCP 호환 에이전트가 레시피를 검색하고 검색할 수 있게 하는 것입니다. 셀프 호스팅 배포는 공개 사이트에 해당 자격 증명을 넣지 않고도 승인된 업스트림 MCP 서버의 컨텍스트 허브로 구성할 수도 있습니다.

검색된 컨텍스트는 절대 변경 권한을 부여하지 않습니다. 저장소, 티켓, 시크릿, 배포 또는 프로덕션 시스템을 변경할 수 있는 모든 커넥터는 호출 호스트가 별도로 구성하고 승인해야 합니다.

일반 도구:

• recipes_search

• recipes_list

• recipes_get

• recipes_cve_catalog_info

• recipes_cve_search

• recipes_cve_get

• recipes_match_finding

• recipes_playbooks_list

• recipes_playbook_get

• recipes_playbook_plan

• recipes_mcp_upstream_servers

• recipes_mcp_upstream_tools

• recipes_mcp_upstream_call

• recipes_mcp_upstream_context

MCP 서버는 두 가지 생성된 레시피 피드를 모두 수용합니다:

• /api/recipes.json은 카테고리, 심각도, CVE/GHSA, 에코시스템 및 인계 메타데이터가 포함된 선호 에이전트 피드입니다.

• /recipes-index.json은 레거시 소비자를 위해 계속 지원됩니다.

• /recipes-browser.json은 컴팩트한 대화형 라이브러리 피드입니다. /recipes/ 페이지는 18개의 크롤링 가능한 레시피 카드와 정확히 일치하는 하이드레이션 시드를 서버 렌더링한 다음, 방문자가 검색, 필터, 정렬에 집중하거나 필터링된 URL을 따르거나 더 많은 항목을 로드할 때만 전체 피드를 요청합니다.

전체 CVE 카탈로그는 MCP 없이도 사용할 수 있습니다:

• /api/cve-catalog/manifest.json은 정확한 날짜/심각도 정책, 소스 해시, 적용 범위 수 및 샤드 인벤토리를 선언합니다.

• /api/cve-catalog/runtime-summary.json은 적용 범위 합계와 모든 런타임 자산의 콘텐츠 파생 캐시 버전이 포함된 작은 브라우저 부트스트랩입니다.

• /api/cve-catalog/index.json은 /api/cve-catalog/indexes/ 아래의 완전한 발행 연도 파티션에 대한 작은 매니페스트입니다. 오프라인 소비자는 필요한 연도만 가져올 수 있습니다. 브라우저 페이지 로드나 정확한 MCP 조회는 해당 파티션을 구문 분석하지 않습니다.

• /api/cve-catalog/search는 제한된 동일 출처 광범위 검색 엔드포인트입니다. runtime-summary.json이 선언한 샤드 세트 개정판에 고정되어 있고, nginx에서 속도 제한되며, 최대 100개의 미리보기를 반환합니다. 프로덕션 MCP 이미지는 동일한 매니페스트에 대해 구축되고 전체 파일 검증된 읽기 전용 SQLite FTS 데이터베이스에서 이를 제공합니다. 포커스만 있고 불완전한 CVE-YYYY-NNNN 식별자가 있는 경우 검색 요청을 하지 않습니다.

• /api/cve-catalog/records/{cve}는 제한된 동일 출처 정확 레코드 엔드포인트입니다. 모든 요청은 샤드 세트 개정판을 고정하고, MCP 서비스는 해당 CVE를 포함하는 결정론적 샤드 하나만 검증하고 엽니다. 현재 브라우저는 샤드 네임스페이스를 학습하는 대신 이 엔드포인트를 사용합니다.

• /api/cve-catalog/browser-index.json.gz는 이전 런타임 요약이 검색 및 레코드 API를 선언하지 않는 경우 한 번의 호환성 기간 동안 유지됩니다. API가 선언되면 현재 브라우저는 이를 다운로드하지 않으므로 방문자는 더 이상 전체 코퍼스 전송 또는 메모리 비용을 지불하지 않습니다.

• 표준 CVE 페이지는 개요, 영향 버전 증거, 선택된 수정 권위, AI 구현 및 검증 인계, 소스, 출처, 인용 및 스키마를 서버 렌더링합니다. 카탈로그 애플리케이션을 포함하거나 하이드레이션하지 않습니다. 브라우저 페치를 추가하지 않고 기계 판독 가능한 출처를 위해 정확한 gzip JSON Lines 샤드에 대한 컴팩트 링크가 계속 제공됩니다.

• /api/cve-catalog/search-indexable.json은 표준 CVE 페이지, 관련 CVE 링크 및 검색 발견을 위한 컴팩트하고 무결성 해시된 허용 목록입니다. 해당 정책은 결정론적 레시피 준비 증거 계약을 통과하는 검토된 안정적인 Markdown 또는 완전한 AI 강화만 허용합니다. 모든 브라우저 결과는 로컬 /cve/<ID>/ 레코드에 연결됩니다. 허용 목록에 있는 레코드는 인덱싱 가능한 정적 페이지로 구체화됩니다. 다른 모든 레코드는 noindex,follow가 있는 제한된 런타임 렌더러를 사용하고 레코드에 공식 CVE.org 소스를 유지합니다.

• /api/cve-catalog/archetypes.json에는 모든 카탈로그 레코드에 대한 보수적인 레시피를 구성하는 데 사용되는 검토된 수정 계약이 포함되어 있습니다. 또한 브라우저와 MCP 서버가 공유하는 버전 관리된 에이전트 액션 스키마와 에코시스템별 파일 대상 힌트가 포함되어 있습니다.

• 각 파티션은 범위 내 모든 CVE를 무결성 해시된 압축 JSONL 샤드에 매핑합니다. 샤드 레코드에는 정확한 CVE 검색을 위한 CVSS, CWE, 제한된 CPE, 참조 및 KEV 출처가 포함됩니다.

• 레코드를 제한된 크기로 유지하기 위해 샤드는 소스 일치 총계와 명시적 잘림 플래그와 함께 최대 12개의 취약한 CPE/버전 행을 저장합니다. 해당 플래그가 설정된 경우 소비자는 NVD/공급업체 증거를 따라야 합니다.

정식 CVE 페이지는 표시되는 소스 목록과 구조화된 데이터 인용에 하나의 기본 참조 집합을 사용합니다. 원시 생성 레코드는 NVD, CVE.org, 범위가 지정된 CISA KEV 레코드, 그리고 소스 연결 공급업체 권고, 패치, 릴리스 노트 또는 완화 조치를 허용합니다. 손상된 링크, 타사 전용 링크, 익스플로잇 전용 링크, 일반 취약점 데이터베이스 링크는 자동으로 승격되지 않습니다. 안정적인 검토된 Markdown은 References 섹션에서 추가 HTTPS 증거를 의도적으로 인용할 수 있습니다. 완화 조치가 여러 지원 브랜치 또는 제품군에 걸쳐 있는 경우, 표시된 조치는 신뢰할 수 있는 모든 수정 릴리스 주장을 보존하며 불완전한 단일 업그레이드로 안내를 축소하지 않습니다.

개발 및 카탈로그 소유의 안정적인 CVE Markdown은 순수 정적 빌드에서 독립 페이지를 생성하지 않으며 Eleventy 및 일반 레시피/검색 피드, 태그 페이지, RSS, 사이트맵에서 제외됩니다. 사전 카탈로그의 세 가지 기록적 안정 레시피는 일반 렌더링 콘텐츠로 유지됩니다. 프로덕션은 nginx와 MCP 기반 랜딩 서비스를 통해 레거시 레시피 URL을 정식 CVE 경로로의 리디렉션으로 유지할 수 있습니다. 전체 검색에는 전용 카탈로그 또는 recipes_cve_* MCP 도구를 사용하세요.

브라우저의 정확한 ID 경로와 개정 고정 검색 API는 매니페스트가 선언한 모든 범위 내 Medium, High, Critical 레코드를 다룹니다. MCP 서버는 recipes_cve_search를 통해 동일한 SQLite 기반 커버리지를 노출합니다. 성공적인 recipes_cve_get은 정규화된 소스 레코드, 소스 식별자 및 참조, 적용 가능한 아키타입, 구성된 완화 계약, 자체 포함된 agentic_change_plan을 반환합니다. 이 계획은 각 완화 및 수정 지침을 검증, 롤백, 증거, 승인, 트라이지 요구사항이 포함된 순서화된 코드/파일 작업으로 확장합니다. 또한 소스 매칭 집합이 제한된 레코드를 초과할 때 명시적 CPE 잘림 메타데이터를 보존합니다.

일일 CVE 동기화 및 선택적 AI 강화

.github/workflows/cve-catalog-sync.yml은 매일 09:23 UTC에 실행되며 수동으로도 실행할 수 있습니다. NVD JSON 2.0 연간 피드와 CISA KEV 카탈로그를 검증하고 결합하며, 모든 카탈로그 인덱스/샤드를 재생성하고, 결과를 검증하고, 레시피 파생 결정적 증거를 종속성 순서로 새로 고치고, 카탈로그 테스트를 실행하고, automation/cve-catalog-sync를 기본 브랜치에 대한 풀 리퀘스트로 열거나 새로 고칩니다. 저장소 Settings > Actions > General > Workflow permissions에서 GitHub Actions가 첫 실행 PR 게시를 위해 풀 리퀘스트를 생성할 수 있도록 허용해야 합니다.

CVE_AUTO_MERGE_ENABLED=true를 설정하면 정확한 헤드 개정이 전용 검증 워크플로우를 통과한 후 안전 승인된 카탈로그 PR을 전달합니다. CVE_AUTOMATION_APP_CLIENT_ID와 CVE_AUTOMATION_APP_PRIVATE_KEY 시크릿이 구성되면 워크플로우는 해당 GitHub App ID를 선호하여 일반 PR 및 메인 브랜치 Build 실행이 자연스럽게 발생합니다. App 자격 증명이 없어도 워크플로우는 자동으로 유지됩니다. 보호된 GITHUB_TOKEN 병합 후 반환된 병합 SHA가 여전히 현재 main인지 확인한 다음 해당 정확한 SHA로 실제 build.yml 워크플로우를 디스패치합니다. 프로덕션 배포 게이트는 CVE 자격이 있는 Build 디스패치만 인식하므로 예약된 모니터와 무관한 수동 워크플로우가 릴리스를 교착 상태에 빠뜨리거나 충족시킬 수 없습니다.

소스 동기화에는 시크릿이 필요하지 않습니다. 레프트오버 골드 검토, 콘텐츠 새로 고침, AI 유지보수, AI 이슈 유지보수, 이 저장소의 보안 상태 작업도 Grok을 사용합니다. XAI_API_KEY라는 이름의 Actions 시크릿 하나를 추가하세요(공식 xAI 환경 변수이며 GROK_API_KEY를 사용하지 마세요):

gh secret set XAI_API_KEY --repo stevologic/security-recipes.ai

워크플로우는 기본적으로 xAI의 grok-4.6 Responses API 모델과 실행당 최대 20개의 신규 또는 소스 변경 레코드를 사용합니다. 예약 큐는 추적된 NVD/CISA 카탈로그에서 파생됩니다. 후보는 유효한 태그가 지정된 공급업체 권고, 패치, 릴리스 노트 또는 완화 URL이 있어야 합니다. 소스 완전 레코드는 소스 기반 완화 종합이 여전히 필요하므로 자격을 유지합니다. 각 KEV 및 심각도 밴드 내에서 결정적 소스 격차가 있는 레코드보다 우선순위가 높으며, 그 다음 영향을 받는 제품/버전 증거와 최신성이 이어집니다. 이는 기존 일일 요청 예산을 사용하며 추가 수동 실행이 필요하지 않습니다. 모델과 제한 모두 선택적 Actions 변수로 변경할 수 있습니다. 강화 제한은 0에서 50으로 하드 바운드됩니다:

gh variable set XAI_MODEL --body "grok-4.6" --repo stevologic/security-recipes.ai
gh variable set XAI_ENRICHMENT_LIMIT --body "20" --repo stevologic/security-recipes.ai

AI 출력은 보조적이며 명시적으로 라벨이 지정됩니다. 엄격한 구조화된 출력을 사용하며 Responses API 웹 검색 출처에서 실제로 반환된 URL만 인용하고 data/cve/ai-enrichments.json에 재현 가능하게 저장됩니다. 완전한 강화는 별도의 게이트가 태그가 지정된 신뢰할 수 있는 권고 참조의 정확한 URL에 연결된 주장 수준의 영향을 받는 제품, 노출, 완화, 검증 증거를 찾을 때만 CVE별 Markdown 초안이 됩니다. 모든 필수 주장은 독립적으로 해당 규칙을 충족해야 하며, 생성된 모든 레시피는 인용된 구체적인 수정 버전 주장이 필요합니다.

캐시된 강화는 영구적이 되지 않고 재평가됩니다. 레시피 준비 항목은 30일 후, KEV 항목은 60일 후, 기타 완전/비특정 또는 증거 불충분 항목은 180일 후에 새로 고침 후보가 됩니다. 수동으로 우선순위가 지정된 CVE는 기존 요청 한도 내에서 새로 고침을 강제합니다. 해당 새로 고침이 실패하면 마지막 유효한 캐시 결과가 계속 첨부됩니다. 유효하지 않은 소스 지문은 실패 폐쇄 상태로 유지됩니다. 동기화 보고서와 자동화 상태 요약은 새로 고침 예정 및 수동 우선순위 수를 노출합니다.

자격이 있는 초안은 content/recipes/cve/ai-enrichment-cve-*.md라는 이름의 maturity: development 파일로 작성됩니다. 일반 레시피 검색 범위 밖에 있으며 안정적인 검토 레시피를 절대 덮어쓰지 않습니다. 인간 검토자는 ai_enrichment_review_status: human-reviewed-development-draft를 설정하여 증거가 준비된 강화를 공개 수정 권한에서 보류하거나 ai_enrichment_review_status: approved-for-ai-authority를 설정하여 해당 사용을 승인할 수 있습니다. 주석이 없는 생성기 소유 초안은 자동 증거 게이트를 유지하며 안정적인 Markdown이 항상 우선합니다. data/cve/ai-generated-recipes.json의 소유권 원장은 각 생성 파일 해시를 기록합니다. 자동화는 변경되지 않은 해시 일치 초안만 새로 고치거나 제거할 수 있습니다. 인간 편집 또는 동일한 CVE에 대한 기존 인간 개발/안정 레시피가 있으면 해당 Markdown은 인간 소유가 되고 자동 교체가 차단됩니다. AI 생성은 소스 CVSS/KEV 사실, 영향을 받는 버전 데이터, 아키타입 선택 또는 검토된 안정 Markdown을 절대 변경하지 않습니다. 키 누락, API 거부, 시간 초과 또는 속도 제한은 NVD/CISA 새로 고침을 차단하지 않습니다. 호출은 3회 연속 실패 또는 15분 예산 후 중지되며 유효한 캐시된 강화는 계속 첨부됩니다. 수동 실행은 명명된 CVE를 우선순위로 지정할 수 있지만 해당 ID는 해당 실행의 기존 한도 내에서 슬롯을 소비하며 레시피 준비 증거 게이트를 절대 우회하지 않습니다:

gh workflow run cve-catalog-sync.yml --ref main \
  -f ai_enrichment_limit=20 \
  -f priority_cve_ids="CVE-2026-58644,CVE-2026-56164"

수동 디스패치는 추가 워크플로우 실행이므로 추가 요청을 할 수 있습니다. 일일 결정적 큐에는 필요하지 않습니다. 기본이 아닌 브랜치에서의 수동 실행은 강화 캐시, 소유권 원장, 생성된 초안을 검토용 단기 워크플로우 아티팩트로 업로드합니다.

.github/workflows/leftover-review.yml은 매일 13:17 UTC에 실행되며 레프트오버 골드 CVE 잔여물을 GitHub Advisories 및 NVD에 대해 실시간 검증합니다. 레프트오버 골드 치명적 및 높음이 먼저 처리됩니다. 해당 항목이 종료된 후 각 실행은 최대 100개의 레프트오버 골드 중간 및 낮음 페이지를 검토하고 완료된 ID를 data/cve/leftover-review-state.json에 기록하며 라벨이 지정된 자동 병합 PR을 엽니다. 레프트오버 검토 작업은 XAI_API_KEY와 함께 Grok Build CLI를 사용하며 해당 시크릿이 없거나 레프트오버 골드 큐가 비어 있으면 no-op입니다.

런타임 경로는 카탈로그 규모 트래픽에 맞게 의도적으로 제한됩니다:

• 허브는 컴팩트 런타임 요약에서 부트스트랩하고, 정확한 조회는 개정 고정 동일 출처 레코드 API를 호출하며, 제목/제품/공급업체/필터 검색은 명시적 검색 의도 후에만 검색 API를 호출합니다.

• 광범위 검색은 변경 불가능한 읽기 전용 SQLite에서 최대 100개의 미리보기를 반환하고, 3초 HTTP 경계가 있으며, 방문자 프로세스나 브라우저 메인 스레드에서 전체 카탈로그를 디코딩하지 않습니다.

• 정확한 레코드 서비스는 요청당 하나의 샤드를 검증하고 엽니다. MCP 정확한 검색은 동일한 샤드 전용 경로를 사용하는 반면, 비정확 텍스트 검색은 전용 실행자, 제한된 입장 큐, 쿼리 마감 시간, nginx 속도 제한 뒤의 매니페스트 고정 SQLite 데이터베이스를 사용합니다.

• 변경 불가능한 브라우저 캐시 키는 업스트림 타임스탬프가 아닌 선언된 레코드/검색 계약, 아키타입 해시, 샤드 집합 개정에서 비롯됩니다.

구현된 빌드 경계, 정확한 샤드 전달 모델, 증거 게이트 SEO 정책, SQLite 검색 런타임, 남은 아티팩트 게시 마이그레이션은 CVE 스케일 아키텍처에 문서화되어 있습니다.

프로덕션 이미지는 캐시된 이미지 레이어에서 SQLite 아티팩트를 한 번 빌드하고, 독립적인 SHA-256 사이드카를 기록하며, 시작 시 스키마, 카탈로그 개정, 레코드 수, 매니페스트 다이제스트, 파일 다이제스트, 대표 FTS 포스팅을 검증합니다. RECIPES_MCP_EAGER_CVE_SEARCH는 이제 SQLite 경로가 구성되지 않은 경우에만 레거시 로컬 폴백에 적용됩니다. 지속적인 검색 트래픽에는 여러 쌍을 이루는 MCP 인스턴스를 실행하세요. 정확한 샤드 읽기는 제한된 텍스트 검색 실행자와 큐에서 격리됩니다.

사이트 마크를 변경한 후 npm run icons를 실행하세요. 프로덕션 성능 게이트에서 확인하는 불투명 Apple 터치 아이콘과 192/512/마스커블 설치 앱 자산을 재생성합니다.

프로덕션 빌드는 nginx gzip_static용 대형 JSON/XML 피드를 사전 압축하고, 안정/초안 검색 경계를 검증하며, npm run check:performance로 페이로드/파일 수 예산을 적용합니다.

Docker로 실행:

docker build -f Dockerfile.mcp-server -t security-recipes-mcp .
docker run --rm -p 8123:80 security-recipes-mcp

MCP 클라이언트를 연결:

http://localhost:8123/mcp

Python으로 로컬 실행:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements-mcp-server.txt
python mcp_server.py

Windows PowerShell 활성화:

.\.venv\Scripts\Activate.ps1
python mcp_server.py

사이트를 로컬에서 실행

전제 조건:

• Node.js >= 20

• 프로덕션 npm run build CVE 사전 렌더링 단계를 위한 requirements-mcp-server.txt가 설치된 Python >= 3.10

• Git

python -m pip install -r requirements-mcp-server.txt
npm install
npm run serve

열기:

http://localhost:8080

npm run serve는 변경 사항을 감시하고 증분 재빌드합니다. 일회성 프로덕션 빌드는 npm run build입니다(출력은 public/에 생성). 빌드는 기존 출력을 삭제하기 전에 Python/종속성 사전 점검을 수행한 다음 MCP 런타임과 동일한 CVE 렌더러를 사용합니다. Eleventy는 의도적으로 static/api/cve-catalog/을 passthrough-copy하지 않습니다. 페이지 구체화 후 제한된 사후 빌드 단계가 해당 카탈로그 하위 트리를 설치하기 전에 링크, 고아 파일, 안전하지 않은 경로, 매니페스트 바이트/해시 불일치를 거부합니다. 카탈로그 외부의 정적 자산(루트 dotfile 포함)은 일반 passthrough 동작을 유지합니다.

격리된 카탈로그 빌드의 경우 SECURITY_RECIPES_CVE_CATALOG_ROOT를 절대 게시 디렉터리로 설정하세요. Eleventy 데이터, 자격 페이지 구체화, 검증된 카탈로그 복사 모두 동일한 루트를 사용합니다. npm run serve는 구체화기나 카탈로그 복사를 다시 실행하지 않으므로 개발 서버에서 정식 /cve/<ID>/ 페이지와 카탈로그 API 트리가 필요할 때 먼저 npm run build를 한 번 실행하세요. 이후 증분 재빌드는 해당 사후 빌드 출력을 유지합니다.

Docker Compose

환경 파일 생성:

cp .env.example .env

스택 시작:

docker compose up -d --build

Docker Compose v2 플러그인(docker compose)을 사용하세요. 레거시 Python docker-compose v1 패키지는 이 스택에서 지원되지 않습니다. 최신 Docker Engine 릴리스에서 로그를 따라갈 때 KeyError: 'id' 또는 컨테이너를 다시 생성할 때 KeyError: 'ContainerConfig'로 충돌할 수 있습니다.

Ubuntu/Debian 호스트에서 Compose v2와 호환성 심을 설치:

sudo bash scripts/install_docker_compose_v2.sh

기본 경로:

site: http://127.0.0.1:8080/
agent recipe feed: /api/recipes.json
MCP endpoint: /mcp

Compose 스택은 공개 사이트와 동적 CVE/MCP 렌더러를 일치하는 블루/그린 쌍으로 유지합니다.

• security-recipes / mcp-server-blue: 블루 사이트 및 렌더러.

• security-recipes-green / mcp-server-green: 그린 사이트 및 렌더러.

• mcp-server: 첫 번째 페어 롤아웃과 하위 호환 가능한 수동 Compose 워크플로를 위해 유지되는 전환기 싱글턴입니다. http://security-recipes/api/recipes.json의 로컬 빌드 사이트 피드를 읽으므로, 포크 또는 드롭릿은 공개 프로덕션 인덱스에 의존하는 대신 자체 레시피를 제공합니다.

deploy.sh는 철수 대상 슬롯의 MCP 컨테이너를 사이트 컨테이너보다 먼저 시작하고 개정을 검증하며, 표준 CVE를 직접 검증한 후에만 해당 페어를 Caddy에 허용합니다. 수동 Compose 시작은 싱글턴 기본값을 유지하므로 첫 번째 롤아웃은 기존에 설치된 스크립트와 호환됩니다.

Let's Encrypt를 사용하는 nginx 또는 Caddy 리버스 프록시의 경우, Docker를 루프백에 바인딩하고 프록시가 공용 포트 80 및 443을 소유하도록 하십시오:

SECURITY_RECIPES_HTTP_PORT=127.0.0.1:8080

그런 다음 프록시 대상:

location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

턴키 호스트 nginx + Let's Encrypt 설정을 원한다면 다음을 실행하십시오:

sudo bash scripts/configure_nginx_letsencrypt.sh \
  --domain security-recipes.ai \
  --email admin@security-recipes.ai

전체 운영자 가이드는 README.nginx-letsencrypt.md에 있습니다.

DigitalOcean 드롭릿

새 Ubuntu 드롭릿의 경우 헬퍼 스크립트를 사용하십시오:

sudo bash scripts/setup_digitalocean_droplet.sh \
  --domain security-recipes.ai \
  --email admin@security-recipes.ai

이 스크립트는 Docker/Compose를 설치하고, 잠긴 앱 사용자를 구성하며, 기본 호스트 강화를 활성화하고, Compose 스택을 시작하며, HTTPS를 위해 Caddy를 앞에 배치할 수 있습니다. 또한 Caddy 인식 Fail2Ban 감옥을 활성화합니다: 한 클라이언트가 5초 이내에 높은 신뢰도의 익스플로잇 프로브 경로(예: .env, Git, WordPress, phpMyAdmin 또는 PHPUnit 프로브)에 대해 최종 HTTP 404 응답을 5회 보내면, 해당 주소가 사이트의 TCP 및 HTTP/3 포트에서 1시간 동안 차단되며, 이후 액세스가 자동으로 복원됩니다. 일반적인 누락 페이지, CVE 형태의 미스, 아카이브 페이지네이션 미스는 차단 예산을 소모하지 않습니다.

설정 전에 apex 및 www DNS 레코드를 모두 드롭릿으로 지정하십시오. 관리형 Caddy는 두 이름 모두에 대한 인증서를 획득하고 www를 apex 표준 호스트로 영구적으로 리디렉션합니다. HTTP에서만 리디렉션하면 HTTPS 크롤러가 TLS 핸드셰이크를 완료할 수 없습니다.

기존 드롭릿은 감옥이 포함된 커밋을 배포한 후 이 일회성, 멱등 활성화가 필요합니다:

sudo bash scripts/configure_caddy_404_ban.sh
sudo fail2ban-client status security-recipes-caddy-404

드롭릿이 여전히 이전 명명된 로그 볼륨으로 번들 Caddy를 실행 중인 경우, 먼저 .env에서 SECURITY_RECIPES_TRAFFIC_LOGS_SOURCE=/var/log/caddy를 설정한 다음 유지보수 창 동안 Caddy만 한 번 재생성하십시오:

docker compose --profile caddy up -d \
  --no-deps --force-recreate --pull never caddy
sudo bash scripts/configure_caddy_404_ban.sh

필터는 스푸핑 가능한 전달 헤더나 User-Agent 값이 아닌 Caddy의 구조화된 client_ip를 사용합니다. 오리진이 나중에 CDN 또는 로드 밸런서 뒤에 배치되면 차단 작업을 해당 제공업체의 WAF/API로 이동하십시오. 오리진 방화벽은 신뢰할 수 있는 프록시에서 패킷이 도착하는 최종 클라이언트를 직접 차단할 수 없습니다.

감옥은 Googlebot User-Agent 문자열을 신뢰하지 않습니다. 공용 클라이언트를 집계하기 전에 Google의 역방향-후-정방향 DNS 검사를 수행합니다: PTR 호스트 이름이 googlebot.com 아래에 있어야 하며, 해당 호스트 이름을 확인하면 동일한 IP가 반환되어야 합니다. 결과는 IP별로 1시간 동안 캐시됩니다. 조회 오류와 5초 리졸버 제한 시간은 폐쇄 실패하므로, 검증되지 않은 클라이언트는 스캐너 경로 404 예산의 적용을 계속 받습니다.

완전히 Compose로 관리되는 Caddy 배포의 경우 Fail2Ban을 스택에서 실행할 수 있습니다. .env에서 DEPLOY_COMPOSE_FAIL2BAN=true를 설정하고 Caddy의 로그 소스를 기본 caddy_logs 볼륨(또는 호스트 바인드)에 유지하십시오. 다음 실행 시 deploy.sh는 Fail2Ban 컨테이너를 가져오고, 시작하고, 상태를 확인하고, 이후 업데이트합니다. 또한 감옥을 시작하기 전에 Caddy의 액세스 로그 파일을 초기화합니다. Fail2Ban은 구성된 파일이 존재해야 하기 때문입니다. 배포를 기다리지 않고 수동으로 시작하려면 다음을 사용하십시오:

docker compose up -d caddy fail2ban
docker compose exec fail2ban fail2ban-client status security-recipes-caddy-404

컨테이너는 호스트 네트워크 네임스페이스를 공유하며 감옥의 nftables 규칙을 호스트 및 Docker 전달 웹 트래픽에 적용하는 데 필요한 NET_ADMIN/NET_RAW 기능만 보유합니다. 호스트 security-recipes-caddy-404 감옥이 활성화된 동안 Compose 감옥을 활성화하지 마십시오. 방화벽 규칙의 소유자는 하나만 선택하십시오. 이는 반복적인 애플리케이션 계층 404 스캐닝을 완화하지만, 업스트림 대용량 DDoS 보호 또는 요청 속도 제한을 대체하지는 않습니다. 옵션이 false인 경우 deploy.sh는 호스트 fail2ban 패키지를 요구하지 않습니다. 호스트 관리 설치물은 드롭릿 설정 및 scripts/configure_caddy_404_ban.sh 워크플로의 책임으로 남습니다.

드롭릿에서 Caddy 대신 nginx를 선호하는 경우, 프록시 없이 호스트를 부트스트랩한 다음 nginx 헬퍼를 실행하십시오:

sudo bash scripts/setup_digitalocean_droplet.sh --no-caddy
sudo bash scripts/configure_nginx_letsencrypt.sh \
  --domain security-recipes.ai \
  --email admin@security-recipes.ai

로컬 전용 또는 사전 프록시된 드롭릿의 경우:

sudo bash scripts/setup_digitalocean_droplet.sh --no-caddy --no-firewall --no-upgrade
docker compose up -d --build

이전 docker-compose v1 실행이 KeyError: 'ContainerConfig'로 실패한 경우, Compose를 업그레이드하고 스택을 재생성하기 전에 오래된 프로젝트 컨테이너를 제거하십시오:

sudo bash scripts/repair_docker_compose_containerconfig.sh
hash -r
command -v docker-compose
docker-compose version

프로덕션 배포는 main의 필수 GitHub Actions Build 워크플로가 게시한 커밋 주소 지정 사이트 및 MCP 이미지를 가져와 https://security-recipes.ai/에서 제공합니다. 동일한 타이머가 development 이미지를 https://dev.security-recipes.ai/에도 배포합니다. 드롭릿은 배포 중 Node, Eleventy, pip 또는 Docker 이미지 빌드를 실행하지 않으므로 1 CPU / 2 GB 메모리 범위 내에서 배포가 유지됩니다.

일회성 페어 MCP 배포 업그레이드

페어 MCP 서비스를 도입하는 첫 번째 배포 전에 배포 스크립트만 업데이트한 다음 실행하십시오. 이미 실행 중인 이전 deploy.sh 프로세스는 페어 Compose 파일이 존재하기 전에 파싱되었으므로, 해당 롤아웃 중에 실행 중인 싱글턴 MCP를 재생성할 수 있습니다:

git fetch origin main
git checkout origin/main -- deploy.sh
bash deploy.sh

새 스크립트는 실행 중인 싱글턴을 그대로 두고, 비활성 MCP와 사이트를 함께 준비한 다음 하나의 단위로 전환합니다. 이 일회성 단계 후에는 기존 bash deploy.sh cron 항목을 변경할 필요가 없습니다.

첫 번째 성공적인 main 워크플로는 두 개의 GHCR 패키지를 생성합니다. 이를 공개로 설정하거나, 배포 서비스에서 사용하는 루트 계정을 패키지를 읽을 수 있는 세분화된 토큰으로 인증하십시오:

printf '%s' "$GHCR_READ_TOKEN" |
  sudo docker login ghcr.io --username stevologic --password-stdin

MCP 통합 철학

MCP를 사용하여 에이전트에 컨텍스트를 제공하되, 검증되지 않은 권한을 부여하지 마십시오.

CVE MCP 도구는 계획과 증거만 반환합니다. 저장소를 편집하거나 환경을 변경하지 않습니다. 승인된 에이전트 호스트는 반환된 계획을 적용할 수 있지만, 먼저 영향받는 표면과 실제 저장소 경로를 증명하고, 관련 없는 변경 사항을 보존하며, 선언된 프로덕션/외부 승인을 획득하고, 기계적으로 사용 가능한 롤백을 유지해야 합니다. 가능한 파일 글로브는 발견 힌트일 뿐, 파일이 취약하다는 증거나 수정 권한이 아닙니다. 각 작업 내에서 유효한 target_kinds만 기본 후보입니다. archetype_target_kinds는 컨텍스트이지 권한이 아닙니다. 조건부 대상은 저장소가 영향받는 구현을 소유하고 있음을 증명해야 하며, 금지된 대상은 절대 편집해서는 안 됩니다. 펌웨어 및 바이너리 대상은 권위 있는 참조, 핀, 교체, 정책, 인벤토리, 소스 또는 빌드 변경을 의미합니다. 벤더 아티팩트 바이트를 패치하는 것이 절대 아닙니다.

NVD/CNA 설명, 권고, 링크, 패치, 이슈 댓글, 릴리스 노트 및 개념 증명 콘텐츠는 신뢰할 수 없는 증거입니다. 에이전트는 이들에서 입증된 취약점 및 버전 사실을 추출할 수 있지만, 포함된 지침이나 명령을 실행하거나 따르면 안 됩니다.

좋은 컨텍스트 소스는 다음과 같습니다:

• 저장소 및 코드 보안 컨텍스트를 위한 공식 GitHub MCP 기능,

• 승인된 경우 Semgrep 및 Snyk 에이전트/MCP 통합,

• OSV, GitHub Advisories, deps.dev, 패키지 레지스트리 및 NVD 기반 미러,

• SARIF, SBOM, CI, 소유권 및 내부 런북 소스,

• 읽기 전용 문서 커넥터.

쓰기 가능한 커넥터는 별도 검토가 필요합니다. 티켓 생성, 브랜치 변경, 배포, 비밀 회전, 클라우드 변경 및 SOAR 작업은 에이전트가 레시피를 읽을 수 있다는 이유만으로 활성화되어서는 안 됩니다.

기여

기여는 레시피 라이브러리를 개선해야 합니다:

• 새로운 수정 레시피,

• 더 나은 프롬프트,

• 더 명확한 에이전트 설정,

• MCP 통합 예제,

• 검토자 체크리스트,

• 문서 수정.

풀 리퀘스트를 열기 전에 비밀, 내부 호스트 이름, 고객 데이터 및 비공개 취약점 세부 정보를 제거하십시오.

제출 전에 로컬 빌드를 실행하십시오:

python -m pip install -r requirements-dev.txt
python scripts/run_checks.py
npm run build

라이선스

프로젝트의 원본 코드, 문서, 수정 레시피, 생성된 사이트 및 MCP 서버는 Apache License 2.0에 따라 라이선스가 부여됩니다. 이는 독점 회사 시스템에 통합하는 것을 포함하여 사적 및 상업적 사용, 수정, 재배포를 허용하며, 라이선스의 고지 및 변경 표시 요구 사항을 따릅니다.

소스 취약점 데이터 및 번들된 타사 소프트웨어는 자체 약관과 귀속 요구 사항을 유지합니다. NOTICE 및 THIRD_PARTY_NOTICES.md를 참조하십시오.