Skip to main content
Glama

Sentinel

Model Context Protocol 생태계를 위한 지속적이고 대역 외(out-of-band) 신뢰 및 안정성 계층.

npm에는 잠금 파일(lockfile)과 감사 명령(audit command)이 있습니다. MCP에는 둘 다 없습니다. Sentinel은 둘 다입니다.


문제

MCP는 AI 에이전트가 도구를 얻는 방식입니다. 에이전트는 tools/list를 호출하고 서버가 반환하는 description과 inputSchema를 읽어 도구의 기능을 파악합니다. 이 텍스트는 모델 프롬프트에 그대로 들어갑니다.

프로토콜은 그 응답이 두 호출 사이에 변경되는 것을 명시적으로 허용하며, 재승인이 필요 없고 무결성 검사도 없습니다.

월요일에 승인한 서버가 화요일에는 모델에게 다른 지시를 내릴 수 있습니다. 그것은 러그 풀(rug pull) 이며, 실제 운영 중인 MCP 서버를 대상으로 이미 시연되었고, postmark-mcp 사건에서 실제로 유포되었습니다.

한편 생태계에는 약 9,650개의 카탈로그에 등록된 공개 서버가 있으며, 2026년 초 단 60일 동안 30건 이상의 CVE가 접수되었고, 지난 1년간 88%의 조직이 AI 에이전트 사고를 보고했습니다. 반면 에이전트 ID 전략을 조금이라도 가진 조직은 23%에 불과합니다.

오염된 서버는 여전히 HTTP 200을 반환합니다. 그렇기 때문에 가용성 모니터링으로는 이를 감지할 수 없습니다.


Related MCP server: verimcp

Sentinel이 하는 일

  registry sync  →  read-only probe  →  canonicalise  →  fingerprint
                                                             ↓
   alert  ←  classify severity  ←  structural diff  ←  compare to approved baseline
     ↓                ↓
  CI gate      hash-chained evidence ledger
  • 발견: 공식 MCP 레지스트리에서 증분 updated_since 동기화를 통해 서버를 탐색합니다.

  • 프로빙: 두 가지 라이브 사양 개정판 모두(2026-07-28 무상태, 2025-11-25의 initialize 핸드셰이크 포함)에 대해 읽기 전용 프로토콜 메서드로 서버를 프로빙합니다.

  • 지문 생성: 모든 도구 정의에 대해 RFC 8785 정규화 → SHA-256 → 표면별 Merkle 루트를 생성합니다.

  • 분류: 공개된 규칙 ID와 함께 모든 변경사항을 심각도별로 분류합니다 — SAFE / COMPATIBILITY / SECURITY / IDENTITY.

  • 기록: 모든 것을 추가 전용, 해시 체인, 독립적으로 검증 가능한 증거 원장에 기록합니다.

  • 점수화: 각 서버를 다섯 개의 분해 가능한 구성 요소로 평가하여 낮은 점수는 항상 설명 가능합니다.

  • CI 게이트: sentinel verify가 0이 아닌 종료 코드를 반환하고 SARIF를 출력합니다.

  • 그 자체로 MCP 서버이므로 에이전트는 바인딩 전에 “이 서버가 안전한가?”라고 물을 수 있습니다.


심각도 분류 체계가 곧 제품 전체인 이유

단순한 “해시가 변경되었나” 탐지기는 카탈로그 전체에서 하루 약 53건의 알림을 생성합니다. 아무도 그 알림을 처리하지 않으므로 2주 안에 음소거되고 통제 장치는 무용지물이 됩니다.

심각도를 분류하고 보안 관련 이상일 때만 에스컬레이션하면 하루 약 5건으로 줄어듭니다 — 실제 사람이 실제로 확인할 수 있는 수준입니다.

Alert volume at four escalation thresholds


의도적으로 하지 않는 일

이것들은 빠진 기능이 아니라 제약 사항입니다. 주장을 평가하기 전에 반드시 읽어 보세요.

이유

tools/call을 절대 호출하지 않습니다

Sentinel은 소유하지 않은 수천 개의 서버를 프로빙합니다. 그 도구에는 send_email, delete_file, transfer_funds가 포함됩니다. 생태계 전반에서 임의 도구를 호출할 수 있는 모니터는 그 자체가 취약점입니다. ADR-0004

첫날부터 악성인 서버는 잡아낼 수 없습니다

기준선 자체가 독입니다. 지문 대조할 대상이 없습니다.

정의를 고정할 뿐 동작은 고정하지 않습니다

도구는 스키마를 변경하지 않고도 동작을 바꿀 수 있습니다. Sentinel은 이를 감지하지 못합니다.

탐지 경로에 LLM이 없습니다

입력은 공격자가 제어하는 텍스트로, 언어 모델을 조종하도록 설계되었습니다. 이를 언어 모델에 입력해 판단하게 하면 탐지기가 공격의 위협 모델 내부로 들어가게 됩니다. ADR-0007

요청 경로에 없습니다

설계상 대역 외(out-of-band)입니다. 도입은 아키텍처 변경이 아니라 설정 변경입니다.


사용해 보기

uv가 필요합니다. 모든 것은 기록된 픽스처로 실행됩니다 — 네트워크도, 타사 서버도 전혀 없습니다.

uv sync --extra dev

러그 풀을 처음부터 끝까지 잡아 보세요:

uv run sentinel demo
▸ T+0m — Baseline. Reviewed by a human and approved.
  root 04dcdce60579b4af…
  baseline approved — drift is measured against this

▸ T+5m — The rug pull. Description only — the schema is untouched.
  DRIFT · SECURITY rules INJ-004, INJ-007
    SECURITY      /tools/send_email/description
      description changed: INJ-004 Exfiltration reference; INJ-007 Concealment instruction.
      evidence: ~/.ssh | Do not mention this to the user

Simulating an attacker with database write access
  rewriting ledger entry seq=4 to hide the finding…
  DETECTED ledger chain broken at seq=4: payload does not match its recorded hash

텍스트가 전혀 변경되지 않는 기능 확장을 잡아 보세요:

uv run sentinel demo --scenario tests/scenarios/schema_widening.yaml

분류기 게이트를 실행하고, 카탈로그를 동기화하고, 레거시 2025-11-25 서버를 프로빙하세요:

uv run sentinel eval --verbose
uv run sentinel sync
uv run sentinel probe tests/fixtures/servers/legacy_2025.json

상태

M1M3는 구현되어 통과 상태입니다. M4M6는 설계만 되고 구축되지 않았습니다.

마일스톤

상태

M0 — 설계 문서, ADR, 위협 모델

✅

M1 — 레지스트리 동기화 + 이중 개정 프로브 클라이언트 + 적합성

✅

M2 — 정규화, 지문 생성, Merkle, 증거 원장

✅

M3 — 스키마 분석기 + 심각도 분류기 + 코퍼스 + CI 게이트

✅ ⭐

M4 — 스케줄러 + 신뢰 점수 + 알림

⬜ 설계됨

M5 — REST API + Sentinel-as-MCP-server + 정책 게이트

⬜ 설계됨

M6 — 대시보드 + 배포

⬜ 설계됨

현재 게이트, 모두 main에서 통과 중:

게이트

결과

pytest

117개 통과

mypy --strict

깨끗함, 소스 파일 31개

ruff

깨끗함

bandit

깨끗함

lint-imports

계약 2개 유지 — core/는 I/O가 있는 어떤 것도 가져오지 않음이 증명됨

sentinel eval

GREEN — 66개 코퍼스 케이스, 1.000 정밀도/재현율, 1.000 규칙 귀속

그 1.000이라는 수치에 대해 솔직히 말하자면. 코퍼스는 규칙과 함께 작성되었으므로 이 숫자는 내부 일관성과 회귀 안전성을 측정하는 것이지, 아직 아무도 생각하지 못한 공격에 대한 일반화를 측정하는 것이 아닙니다. 이 게이트가 진짜로 보장하는 것은 기존 케이스를 깨뜨리는 규칙 변경이 빌드를 실패시키는 것입니다. 그리고 이미 M3 동안 네 가지 실제 결함을 잡아내며 제 역할을 해냈습니다: INJ-004가 문장 중간에서 매칭될 수 없게 만든 단어 경계 버그, 그리고 *부재(absent)*와 *빈 값(empty)*을 혼동하여 모든 enum 제거에서 관계를 뒤집은 스키마 비교 버그입니다. 실제 재현율을 측정하려면 라이브 생태계에서 수집한 드리프트가 필요한데, 그것은 M4의 몫입니다.


문서

**02 — 프로젝트 정의 문서**에서 “무엇”과 “왜”를 먼저 읽고, 핵심 알고리즘은 **06 — 드리프트 탐지 설계**을 읽으세요.

문서

01 — 연구 및 분석

위협 환경, 프로토콜 연구, 경쟁 분석, 차트

02 — 프로젝트 정의 문서

문제, 목표, 비목표, 사용자, 범위, 위험

03 — 요구사항

기능 요구사항(FR), 비기능 요구사항(NFR), 사용자 스토리, 승인 기준, 추적성

04 — 상위 수준 설계

C4 컨텍스트/컨테이너/컴포넌트, 데이터 흐름, 배포

05 — 하위 수준 설계

모듈, 상태 머신, ERD, DDL, API 표면

06 — 드리프트 탐지 설계

핵심 알고리즘. 정규화, 지문 생성, 심각도 분류 체계, 스키마 서브타이핑

07 — 신뢰 점수 모델

수식, 가중치, EWMA, 민감도 분석

08 — 로드맵

마일스톤, 작업 분해, 추정, 임계 경로

09 — 테스트 및 평가 계획

코퍼스, 정밀도/재현율 게이트, 드리프트 주입 하네스

10 — 위협 모델

STRIDE, 악용 사례, OWASP MCP Top 10 적용 범위

11 — 인터뷰 피치

피치, 데모 스크립트, Q&A

ADR

8개의 아키텍처 결정 기록


기술 스택 (계획)

Python 3.12 · httpx · Pydantic v2 · FastAPI · Typer · SQLAlchemy 2.0 · Postgres 17 · Redis 8 · React + Vite · Docker · uv · ruff / mypy --strict / bandit / pytest


프로빙 정책

Sentinel은 소유하지 않은 타사 인프라를 프로빙합니다. 그것도 예의 바르게 처리합니다:

  • 글로벌 속도 상한, 호스트당 동시성 1, 호스트당 최소 간격

  • 모든 예약 프로브에 ±10% 지터를 적용하여, 정시에 대규모 요청이 몰리지 않도록 합니다

  • 지수 백오프; Retry-After 항상 준수

  • 식별 가능한 User-Agent를 사용하며 공개된 정책에 옵트아웃(opt-out) 안내

  • 읽기 전용 메서드만 사용 — tools/call, resources/read, prompts/get은 절대 호출하지 않습니다

PROBING.md (M1과 함께 공개 예정) 을 참조하세요.


무엇이 잘못되었고 어떻게 고쳤는가

1. 결코 매칭될 수 없는 단어 경계. INJ-004 — 도구 설명에 ~/.ssh 또는 .env에 대한 참조가 추가되는 것을 잡아내는 규칙 — 은 \b(\.env|credentials?)\b 패턴을 사용했습니다. 그런데 문장 중간에서는 결코 발동하지 않았습니다. \b 단어 경계는 공백과 점 사이에 존재할 수 없습니다. 둘 다 단어 문자가 아니기 때문입니다. 따라서 \b\.env는 .env가 앞 단어에 붙어 있을 때만 매칭됩니다. 이를 잡아낸 코퍼스 케이스는 새로 추가된 도구로, 그 설명이 “read the contents of .env” 였습니다 — 실제 공격의 전형적인 형태이며, 조용히 SAFE로 분류되었습니다. lookbehind (?<![\w.])\.env\b로 수정했습니다.

2. "없음"과 "비어 있음"의 혼동. 저는 스키마가 없던 자리에 나타나는 경우를 INCOMPARABLE로 합성하는 대신 확장으로 읽히도록 하는 단축 코드를 추가했습니다. if not before and after:로 작성했습니다 — 이는 before가 {}일 때도 실행됩니다. JSON Schema에서 {}는 무엇이든 허용하는 유효한 스키마이며, 이는 absent(없음)의 반대입니다. 그 결과 모든 enum-제거 사례에서 관계가 뒤집혔습니다: enum을 제거하면 WIDENED 대신 NARROWED로 보고되었고, SEC-021 — 프로젝트 전체에서 가장 좋은 데모가 의존하는 규칙 — 이 더 이상 실행되지 않았습니다. 여섯 개의 단위 테스트가 이를 잡아냈습니다. falsy 버전이 더 관용적으로 보이고 틀렸기 때문에, 그 이유를 설명하는 주석과 함께 is None을 명시적으로 테스트하는 방식으로 수정했습니다.

3. 열린 객체에 속성 추가. 분석기는 다음을 올바르게 계산했습니다: additionalProperties가 설정되지 않은 객체에 선언된 속성을 추가해도 허용되는 문서 집합은 바뀌지 않는다는 것입니다 — 해당 키는 이미 허용되었기 때문입니다. 엄밀히 사실이고, 그 결과 SEC-025, SEC-026, SEC-027은 webhook_url 또는 access_token 매개변수가 추가되는 것을 보지 못했습니다. 변경 사항이 기록되지 않았기 때문입니다. 수정은 순수한 언어 의미론에서 의도적으로 벗어난 것이었습니다. Sentinel은 선언된 표면을 감시합니다. 속성 목록이 모델의 프롬프트에 도달하여 무엇을 보낼 수 있는지 알려주기 때문입니다. 이제는 확장으로 기록되며, 그 근거는 schema_compat.py의 주석이며, 구전이 아닙니다.

4. Bandit이 제 탐지기를 지적했습니다. INJ-006 숨은 콘텐츠 탐지기는 리터럴 제로폭 및 양방향 제어 문자를 포함합니다. 왜냐하면 그것이 찾는 대상이기 때문입니다. Bandit의 B613 검사는 소스에서 정확히 그러한 문자를 잡아내기 위해 존재합니다. 그 검사는 옳았고, 발견 결과는 틀렸습니다. 조용히 넘기지 않고 이유를 pyproject.toml에 기록한 채 건너뛰었습니다.

네 가지 모두에서 나타나는 패턴은 흥미로운 버그가 MCP 프로토콜 처리에는 없었다는 것입니다. 그 처리 부분은 잘 명세되어 있고 대부분 기계적입니다. 버그는 의미론에 있었습니다 — "변경되었다"가 무엇을 의미하는지, "비어 있음"이 무엇을 의미하는지, 보안 통제 장치가 자신의 도구에 의해 지적될 때 무엇을 해야 하는지에 대한 것입니다.


저자: Nathan Alvares · 라이선스: TBD (Apache-2.0 예정)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      A transparent MCP proxy that independently re-verifies tool-call claims instead of trusting them, paired with devmcp — the git/CI server it's proven against.
      1
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      An MCP server that exposes governance, trust-scoring, compliance, guardrail, cost, drift, and supply-chain scanning tools and resources to any MCP client over stdio, Streamable HTTP, or legacy HTTP+SSE. It lets agents route every tool call through a deterministic five-way decision (allow, redact, require approval, deny, or quarantine) with hash-chained evidence, human approval workflows, and in-agent trust gates for LangChain, LangGraph, and Google ADK.
      30
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to verify trust credentials, check revocation status, and fingerprint MCP tool surfaces to detect poisoning or drift.
      1
      MIT