Python 코드로 동작을 작성하고 실행하는 AI 에이전트를 만들기 위한 미니멀한 Python 라이브러리입니다.
cisco-ai-defense/mcp-scanner
Cisco의 Python 도구로 YARA 규칙, LLM 분석, Cisco AI Defense를 사용해 MCP 서버 등을 보안 검사합니다.
- 스타
- 1,094
- 포크
- 148
- 열린 이슈
- 74
- 마지막 커밋
- 4일 전
어떤 프로젝트인가요?
MCP Scanner는 Model Context Protocol 서버와 해당 서버의 도구에서 잠재적인 악성 동작과 보안 문제를 검사합니다. 원격 서버(SSE 또는 streamable HTTP), 로컬 stdio 서버, 사전 생성된 JSON 파일을 대상으로 도구, 프롬프트, 리소스, 서버 지침을 검사할 수 있어 CI/CD 파이프라인에서 오프라인으로도 사용할 수 있습니다.
이 스캐너는 YARA 규칙, LLM 기반 분석, Cisco AI Defense inspect API의 세 가지 엔진을 결합합니다. 세 엔진을 함께 실행하거나 각각 따로 실행할 수 있습니다. 추가 모듈로는 MCP 서버 소스 코드의 동작 분석, 번들 바이너리의 VirusTotal 해시 조회, pip-audit를 통한 Python 의존성 취약점 검사, PyPI 및 npm 패키지의 샌드박스 검사 기능이 있습니다.
CLI(mcp-scanner), REST API 서버(mcp-scanner-api), Python SDK로 제공됩니다. 결과는 요약, 상세, 표, 심각도별 그룹화 또는 원시 JSON 형식으로 출력할 수 있습니다.
핵심 기능
- 01MCP 도구, 프롬프트, 리소스, 서버 지침에서 보안 문제를 검사합니다.
- 02YARA 규칙, LLM 기반 분석, Cisco AI Defense inspect API를 결합하며 함께 또는 각각 사용할 수 있습니다.
- 03원격(SSE, streamable HTTP) 및 stdio MCP 서버에 연결하거나, 오프라인에서 정적 JSON 파일을 읽습니다.
- 0410개 프로그래밍 언어를 대상으로 소스 코드 동작 분석 기능을 제공합니다.
- 05pip-audit를 사용해 Python 의존성에서 알려진 CVE, PYSEC, GHSA 취약점을 검사합니다.
- 06CLI, REST API, Python SDK 인터페이스를 제공합니다.
활용 사례
- AI 에이전트에 연결하기 전에 서드파티 MCP 서버를 검증합니다.
- API 키 없이 오프라인 MCP 도구 정의 검사를 CI/CD 파이프라인에 추가합니다.
- MCP 서버를 제공하는 PyPI 또는 npm 패키지를 설치하기 전에 검사합니다.
- 개발자 컴퓨터에 이미 있는 MCP 클라이언트 설정 파일을 감사합니다.
빠른 시작
- 1
uv로 CLI 도구 설치하기
uv tool install --python 3.13 cisco-ai-mcp-scanner - 2
stdio MCP 서버를 YARA로 스캔하기
mcp-scanner --stdio-command uvx --stdio-arg=--from --stdio-arg=mcp-server-fetch --stdio-arg=mcp-server-fetch --analyzers yara --format summary
사용 전 알아둘 점
- Cisco AI Defense API, LLM 제공업체, VirusTotal 등 API 키가 필요한 분석기가 여러 개 있습니다.
- VIRUSTOTAL_API_KEY가 없으면 바이너리 파일은 멀웨어 검사를 하지 않습니다.
- Python 3.11 이상과 uv가 필요합니다.
토픽
자주 묻는 질문
- mcp-scanner은(는) 무엇인가요?
- Cisco의 Python 도구로 YARA 규칙, LLM 분석, Cisco AI Defense를 사용해 MCP 서버 등을 보안 검사합니다. MCP Scanner는 Model Context Protocol 서버와 해당 서버의 도구에서 잠재적인 악성 동작과 보안 문제를 검사합니다. 원격 서버(SSE 또는 streamable HTTP), 로컬 stdio 서버, 사전 생성된 JSON 파일을 대상으로 도구, 프롬프트, 리소스, 서버 지침을 검사할 수 있어 CI/CD 파이프라인에서 오프라인으로도 사용할 수 있습니다.
- mcp-scanner은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- mcp-scanner은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- mcp-scanner은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. mcp-scanner의 마지막 커밋은 2026년 10월 16일입니다.
- mcp-scanner은(는) 어디에 사용할 수 있나요?
- AI 에이전트에 연결하기 전에 서드파티 MCP 서버를 검증합니다. API 키 없이 오프라인 MCP 도구 정의 검사를 CI/CD 파이프라인에 추가합니다. MCP 서버를 제공하는 PyPI 또는 npm 패키지를 설치하기 전에 검사합니다. 개발자 컴퓨터에 이미 있는 MCP 클라이언트 설정 파일을 감사합니다.
- mcp-scanner는 어떻게 설치하나요?
- uv로 CLI 도구 설치하기: uv tool install --python 3.13 cisco-ai-mcp-scanner stdio MCP 서버를 YARA로 스캔하기: mcp-scanner --stdio-command uvx --stdio-arg=--from --stdio-arg=mcp-server-fetch --stdio-arg=mcp-server-fetch --analyzers yara --format summary
- mcp-scanner은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/cisco-ai-defense/mcp-scanner
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
조사, 계획, 코딩 및 작업 실행이 가능한 자율 AI 에이전트를 구축하는 Python 프레임워크로, 메모리, RAG와 100개 이상의 LLM 제공업체를 지원합니다.
Python과 TypeScript에서 도구, MCP, 메모리, 모델 간 이식성을 갖춘 AI 에이전트를 만들고 실행하는 오픈소스 SDK입니다.
순차형, 동시 실행형, 그래프 기반, 계층형 워크플로로 멀티 에이전트 시스템을 구축하고 조율하는 Python 프레임워크.
대화 기록만 재생하는 대신 기억을 저장·회상·성찰해 AI 에이전트가 시간이 지날수록 학습하도록 돕는 에이전트 메모리 시스템입니다.
로컬 또는 호스팅 환경에서 실행할 수 있으며, 모델과 오픈소스 에이전트 하네스를 선택해 사용하는 지식 업무 및 소프트웨어 개발용 에이전트 워크스페이스입니다.