Repolode
제출하기
KryptosAI

KryptosAI/mcp-observatory

MCP 서버의 스키마 변경, 안전한 공격 시뮬레이션, SARIF 출력을 지원하는 오픈소스 CI 네이티브 보안·회귀 테스트 CLI입니다.

GitHub에서 보기웹사이트
스타
120
포크
15
열린 이슈
20
마지막 커밋
3일 전

어떤 프로젝트인가요?

MCP Observatory는 AI 에이전트가 의존하기 전에 Model Context Protocol (MCP) 서버를 테스트하는 명령줄 도구입니다. 서버에 연결해 도구, 프롬프트, 리소스를 확인하고, 선택적으로 안전한 읽기 전용 도구를 호출해 정상 작동 여부를 검증합니다. 또한 0~100점의 상태 점수와 등급을 매깁니다.

이 도구는 CI에 통합하기 좋은 회귀 테스트와 보안 검사에 중점을 둡니다. 서버 세션을 cassette 파일에 기록하고 오프라인에서 재생하거나, 실제 서버가 기록 내용과 일치하는지 확인할 수 있습니다. 두 번의 실행 결과를 비교해 추가되거나 제거된 필드, 호환성을 깨뜨리는 매개변수 변경도 찾아냅니다. 또한 셸 인젝션 위험이 있는 영역, 광범위한 파일 시스템 접근, 자격 증명 유출 등 위험한 패턴이 있는지 도구 스키마를 분석합니다.

결과는 GitHub Code Scanning용 SARIF로 저장할 수 있으며, setup-ci 명령어를 사용하면 GitHub Actions 또는 GitLab CI 워크플로를 생성할 수 있습니다. 이 프로젝트 자체도 MCP 서버로 실행할 수 있어 에이전트가 다른 서버를 대상으로 검사를 호출할 수 있습니다. Node.js 20 이상이 필요하며 npx, Homebrew, Docker로 사용할 수 있습니다.

핵심 기능

  • 01MCP 서버의 도구, 프롬프트, 리소스를 확인하고 0~100점의 상태 점수를 제공합니다.
  • 02두 번의 실행 결과를 비교해 추가·제거되었거나 호환성을 깨뜨리는 변경을 찾아 스키마 변경을 감지합니다.
  • 03세션을 cassette에 기록하고 오프라인에서 재생하거나 검증합니다.
  • 04안전한 공격 시뮬레이션을 실행하고 위험한 도구 스키마 패턴을 표시합니다.
  • 05검사 결과를 SARIF로 내보내고 GitHub Actions 또는 GitLab CI 워크플로를 생성합니다.
  • 06MCP 서버로 실행해 에이전트가 다른 MCP 서버를 테스트하도록 할 수 있습니다.

활용 사례

  • 커스텀 MCP 서버의 CI 파이프라인에 보안 및 호환성 검사를 추가할 때.
  • 서버에 의존하는 에이전트가 문제를 겪기 전에 예상치 못한 도구 스키마 변경을 발견할 때.
  • 서드파티 MCP 서버를 설치하기 전에 위험한 도구 패턴이 있는지 검토할 때.
  • pull request에서 MCP 검사 결과를 GitHub Code Scanning에 업로드할 때.

빠른 시작

  1. 1

    npx로 첫 번째 스캔 실행하기

    npx -y @kryptosai/mcp-observatory@latest
  2. 2

    특정 MCP 서버 테스트하기

    npx -y @kryptosai/mcp-observatory@latest test npx -y @modelcontextprotocol/server-everything
  3. 3

    로컬 대시보드를 열어 결과 확인하기

    npx -y @kryptosai/mcp-observatory@latest dashboard

사용 전 알아둘 점

  • Node.js 20 이상이 필요합니다.
  • ClearFrame 워크플로와 같은 일부 고급 기능은 Apple Silicon만 지원하는 Mac 앱에 연결되어 있습니다.

포함된 컬렉션

오픈소스 AI 에이전트 프레임워크와 앱MCP 서버CLI·터미널 도구보안 스캐너, 감사 및 위협 인텔리전스 도구테스트 프레임워크 & 자동화 테스트 도구

토픽

#mcp#security#testing#ci-cd#schema-drift#sarif#ai-agents#cli#agent-security#ai-agent

자주 묻는 질문

mcp-observatory은(는) 무엇인가요?
MCP 서버의 스키마 변경, 안전한 공격 시뮬레이션, SARIF 출력을 지원하는 오픈소스 CI 네이티브 보안·회귀 테스트 CLI입니다. MCP Observatory는 AI 에이전트가 의존하기 전에 Model Context Protocol (MCP) 서버를 테스트하는 명령줄 도구입니다. 서버에 연결해 도구, 프롬프트, 리소스를 확인하고, 선택적으로 안전한 읽기 전용 도구를 호출해 정상 작동 여부를 검증합니다. 또한 0~100점의 상태 점수와 등급을 매깁니다.
mcp-observatory은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mcp-observatory은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mcp-observatory은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. mcp-observatory의 마지막 커밋은 2026년 11월 4일입니다.
mcp-observatory은(는) 어디에 사용할 수 있나요?
커스텀 MCP 서버의 CI 파이프라인에 보안 및 호환성 검사를 추가할 때. 서버에 의존하는 에이전트가 문제를 겪기 전에 예상치 못한 도구 스키마 변경을 발견할 때. 서드파티 MCP 서버를 설치하기 전에 위험한 도구 패턴이 있는지 검토할 때. pull request에서 MCP 검사 결과를 GitHub Code Scanning에 업로드할 때.
mcp-observatory는 어떻게 설치하나요?
npx로 첫 번째 스캔 실행하기: npx -y @kryptosai/mcp-observatory@latest 특정 MCP 서버 테스트하기: npx -y @kryptosai/mcp-observatory@latest test npx -y @modelcontextprotocol/server-everything 로컬 대시보드를 열어 결과 확인하기: npx -y @kryptosai/mcp-observatory@latest dashboard
mcp-observatory은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/KryptosAI/mcp-observatory

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트

N4darae / shrt

승인된 기준선과 비교해 기록된 API 호출 체인을 백엔드에 재생하고 릴리스 간 변경을 찾아내는 회귀 테스트 도구입니다.

개발 도구#testing#api-testing#regression-testing
2.4천+218 이번 주164GoMIT업데이트 12일 전