owasp_cheatsheets_mcp_server

OWASP 치트 시트를 제공하는 최소한의 모델 컨텍스트 프로토콜(MCP) 호환 서버입니다.

서버는 FastAPI를 사용하여 OWASP Cheat Sheet Series 의 치트 시트 내용을 반환하는 간단한 HTTP API를 제공합니다.

필수 조건

• Python 3.8 이상

• Git(첫 번째 실행 시 치트 시트 저장소를 복제하기 위해)

Related MCP server: Excel MCP Server

용법

1. 설치 요구 사항:

   지엑스피1

2. (선택 사항) 치트 시트의 로컬 사본이 이미 있는 경우 CHEATSHEETS_DIR 설정합니다.

   export CHEATSHEETS_DIR=/path/to/CheatSheetSeries/cheatsheets

3. uvicorn 으로 서버를 실행합니다:

   uvicorn server.app:app --reload

4. CHEATSHEETS_DIR 설정되지 않으면 서버는 처음 시작할 때 치트 시트 저장소를 복제합니다(네트워크 액세스 필요).

엔드포인트

• GET /health – 기본 건강 검진.

• GET /cheatsheets – 사용 가능한 치트시트 파일을 나열합니다.

• GET /cheatsheets/{name} – 특정 치트 시트를 검색합니다.

• GET /search?q=term – 용어에 대한 치트 시트를 검색하고 일치하는 파일 이름을 반환합니다.

프로덕션에서 실행 중

배포 시 명시적인 호스트 및 포트와 함께 uvicorn 사용하세요.

uvicorn server.app:app --host 0.0.0.0 --port 8000

실제 배포의 경우 systemd 와 같은 프로세스 관리자를 사용하거나 역방향 프록시 뒤에서 실행하는 것을 고려하세요.

기여하다

풀 리퀘스트를 환영합니다. pytest를 사용하여 tests/ 디렉터리에 테스트를 추가할 수 있습니다.

이 구현은 MCP 서버의 단순화된 예이며 전체 사양을 다루지 않을 수 있습니다.