SentinelMCP

Model Context Protocol (MCP)를 위한 결정적 정책 방화벽 및 런타임 거버넌스 엔진

개요

SentinelMCP는 Model Context Protocol (MCP) 서버와 다중 에이전트 AI 군집 [1]을 위해 특별히 설계된 프로덕션 등급 보안 게이트웨이이자 런타임 거버넌스 프레임워크입니다. AI 에이전트가 MCP를 통해 엔터프라이즈 파일시스템, 데이터베이스, API에 대한 자율적 접근 권한을 점점 더 많이 얻게 됨에 따라 프롬프트 인젝션, 무단 도구 호출, 데이터 유출과 같은 보안 위험이 급증하고 있습니다.

SentinelMCP는 인라인 정책 방화벽 역할을 하여 JSON-RPC MCP 도구 호출을 가로채고, 선언적 AST 기반 규칙에 대해 인수를 검사하며, 보안 한도를 적용하고, 변경 불가능하고 암호학적으로 검증 가능한 감사 추적을 기록합니다.

Related MCP server: AgentGuard MCP Server

주요 아키텍처 및 기능

• 정책-as-코드 엔진: 도구 이름에 대한 glob 패턴 매칭, 인수 값에 대한 정규식 검사, 엄격한 인수 스키마 검증을 지원하는 선언적 JSON/YAML 정책 정의 [2].

• 암호화 출처 원장: 각 실행 레코드가 SHA-256 해시로 연결되는 추가 전용 감사 로깅으로, 규정 준수 및 감사를 위한 변조 방지 추적성을 보장합니다.

• 고성능 프록시 게이트웨이: FastAPI 및 Pydantic v2 기반으로, 비동기 요청 처리를 통해 서브 밀리초 차단 지연 시간을 제공합니다.

• CLI 및 테스트 도구 체인: 정책에 대한 도구 호출 평가, 게이트웨이 서버 실행, 원장 무결성 검증을 위한 내장 CLI.

• 엔터프라이즈급 CI/CD: pytest로 완전히 테스트되었으며, Python 3.11 및 3.12에서 매트릭스 테스트를 거치고 GitHub Actions 워크플로우와 통합되었습니다.

설치

저장소를 클론하고 개발 종속성과 함께 편집 가능 모드로 설치합니다:

git clone https://github.com/ateeqdesktop-dot/sentinel-mcp.git
cd sentinel-mcp
pip install -e .[dev]

사용법

1. CLI를 통한 도구 호출 평가

SentinelMCP가 보안 정책에 대해 모든 MCP 도구 호출을 어떻게 평가하는지 테스트할 수 있습니다:

sentinel-mcp evaluate --tool fs_delete --args '{"path": "/home/user/document.txt"}' --policy policy.json

2. 게이트웨이 서버 실행

SentinelMCP 프록시 서버를 로컬에서 시작합니다:

sentinel-mcp serve --host 127.0.0.1 --port 8000 --policy policy.json

3. 감사 원장 무결성 검증

추가 전용 감사 추적이 변조되지 않았는지 확인합니다:

sentinel-mcp verify --ledger sentinel_audit.jsonl

정책 구성 예시 (policy.json)

{
  "version": "1.0",
  "default_action": "allow",
  "rules": [
    {
      "id": "block-destructive-fs",
      "tool_pattern": "fs_*",
      "action": "deny",
      "forbidden_arguments": [
        "rm\\s+-rf",
        "/etc/passwd",
        "drop\\s+database"
      ]
    },
    {
      "id": "limit-sql-queries",
      "tool_pattern": "db_*",
      "action": "allow",
      "max_string_length": 500
    }
  ]
}

테스트

pytest 및 코드 커버리지로 테스트 스위트를 실행합니다:

pytest --cov=sentinel tests/ -v

라이선스

MIT 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE를 참조하세요.

참고 문헌

1. Anthropic Model Context Protocol (MCP) 사양. 온라인 이용 가능.

2. 클라우드 네이티브 보안을 위한 Open Policy Agent (OPA) 원칙. 온라인 이용 가능.