MCPKernel — AI 에이전트를 위한 보안 커널

도구 오염, 데이터 유출, 프롬프트 인젝션 및 러그풀 공격을 차단하는 오픈소스 MCP/A2A 보안 게이트웨이입니다. 정책 강제, 오염 추적, 샌드박스 실행, 결정론적 엔벨로프, 기술 감사 및 모든 AI 에이전트 도구 호출에 대한 Sigstore 감사를 제공합니다. Claude Desktop, Cursor, VS Code, Windsurf, OpenClaw 및 모든 MCP 클라이언트와 호환됩니다. OWASP ASI 2026을 준수합니다.

전체 문서 읽기 →

빠른 시작

옵션 A: 보안 게이트웨이 (프록시 모드)

pip install "mcpkernel[all]"
mcpkernel serve --host 127.0.0.1 --port 8000

MCP 클라이언트가 도구 서버를 직접 타겟팅하는 대신 http://localhost:8000/mcp를 가리키도록 설정하세요. 이제 모든 도구 호출이 정책 검사, 오염 스캔, 샌드박스 처리 및 감사 로깅됩니다.

옵션 B: MCP 서버 (도구 모드 — 단일 명령어)

pip install mcpkernel
mcpkernel install claude    # or: cursor, vscode, windsurf, zed, openclaw, goose

이 명령어를 사용하면 IDE에 MCPKernel을 MCP 서버로 추가할 수 있습니다. 이제 에이전트가 mcpkernel_scan_tool, mcpkernel_check_taint, mcpkernel_validate_policy 등을 기본적으로 호출할 수 있습니다.

옵션 C: Python API

from mcpkernel import MCPKernelProxy

async with MCPKernelProxy(
    upstream=["http://localhost:3000/mcp"],
    policy="strict",
    taint=True,
) as proxy:
    result = await proxy.call_tool("read_file", {"path": "data.csv"})

또는 데코레이터 하나로 모든 함수를 보호할 수 있습니다:

from mcpkernel import protect

@protect(policy="strict", taint=True)
async def read_data(path: str) -> str:
    return Path(path).read_text()

Related MCP server: mcp-guardian

왜 MCPKernel인가?

AI 에이전트(LangChain, CrewAI, AutoGen, Copilot, OpenClaw)는 파일을 읽고, 코드를 실행하고, HTTP 요청을 보내는 등 도구를 자율적으로 호출합니다. MCP 생태계는 OpenClaw와 같은 프로젝트에서만 344개 이상의 보안 권고가 보고되었으며, 도구 오염 공격, 권한 상승, 데이터 유출 및 러그풀 익스플로잇을 포함한 치명적인 취약점이 존재합니다.

MCPKernel은 누락된 통제 지점입니다. 에이전트와 MCP 도구 서버 사이에 위치하여 모든 단일 호출에 대해 보안 정책을 강제합니다:

┌─────────────┐     ┌──────────────────────────┐     ┌─────────────┐
│  AI Agent    │────▶│       MCPKernel           │────▶│  MCP Tool   │
│ (LangChain,  │◀────│  Security Gateway        │◀────│  Server     │
│ CrewAI,      │     └──────────────────────────┘     └─────────────┘
│ OpenClaw,    │      │ Policy │ Taint │ Sandbox │
│ Cursor, etc) │      │  DEE   │ Audit │ eBPF    │
└─────────────┘      │ Skills │ DLP   │ Doctor  │

모든 도구 호출에 발생하는 일:

MCP 보안 문제

MCP 생태계는 빠르게 성장하고 있지만 보안은 이를 따라가지 못하고 있습니다. 다음은 MCPKernel이 방어하는 실제 위협입니다:

OpenClaw는 2개의 치명적인 RCE 취약점을 포함하여 344개 이상의 보안 권고를 보유하고 있습니다. MCPKernel은 OpenClaw와 같은 플랫폼에 필요하지만 내장되어 있지 않은 보안 계층입니다.

기능

핵심 보안 파이프라인

• YAML 정책 엔진 — 도구, 인수 패턴 또는 오염 라벨별로 허용/거부/감사/샌드박스 규칙 정의

• 오염 추적 — 도구 호출 인수 내의 비밀, PII, API 키, JWT 자동 감지

• DLP 체인 감지 — 도구 경계를 넘나드는 다중 홉 데이터 유출 방지 (데이터베이스 → HTTP 차단)

• 4개의 샌드박스 백엔드 — Docker, Firecracker 마이크로VM, WASM, Microsandbox

• 결정론적 실행 엔벨로프 (DEE) — 모든 실행은 해싱되고 재현을 위해 Sigstore 서명됨

• OWASP ASI 2026 준수 — ASI-01부터 ASI-08까지 매핑되는 내장 정책 세트

• 추가 전용 감사 로그 — SQLite 기반, 콘텐츠 해싱, CEF/JSONL/CSV/SARIF SIEM 내보내기 지원

위협 탐지 및 스캔

• 도구 오염 스캐너 — MCP 도구 설명 내의 숨겨진 지침, 유니코드 난독화 및 프롬프트 인젝션 감지

• 기술 스캐너 — OpenClaw/ClawHub SKILL.md 파일을 감사하여 위험한 셸 명령, 유출 패턴 및 숨겨진 지침 탐지

• MCP 구성 검색 — Claude, Cursor, VS Code, Windsurf, Zed, OpenClaw, Goose 전반의 MCP 구성 자동 검색

• Snyk 에이전트 스캔 브리지 — Snyk의 agent-scan CLI를 실행하고 결과에서 정책 규칙 자동 생성

다중 클라이언트 통합

• 단일 명령어 설치 — mcpkernel install claude로 지원되는 모든 IDE에 보안 도구 추가

• MCP 서버로서의 MCPKernel — 스캔, 검증, 오염 검사 및 진단 기능을 기본 에이전트 도구로 노출

• 7개의 지원 클라이언트 — Claude Desktop, Cursor, VS Code, Windsurf, Zed, OpenClaw, Goose

• OpenClaw 보안 기술 — OpenClaw/ClawHub 생태계를 위한 설치 가능한 기술 패키지

개발자 경험

• Python API — 프로그래밍 방식 사용을 위한 MCPKernelProxy 클래스 및 @protect 데코레이터

• 정책 프리셋 — 내장된 permissive, standard, strict 프리셋 — 제로 구성 보안

• 닥터 진단 — mcpkernel doctor로 Python, 종속성, 구성, 노출된 비밀, 권한 확인

• VS Code 확장 — 검색된 서버를 위한 트리 뷰, 보안 결과 패널, 통합 명령어

플랫폼 및 관측 가능성

• Kong 스타일 플러그인 파이프라인 — 우선순위에 따른 pre_execution → execution → post_execution → log

• 속도 제한 — LRU 퇴거를 사용하는 ID별 토큰 버킷

• Prometheus 메트릭 + OpenTelemetry — 즉시 사용 가능한 전체 관측 가능성

• 선택적 eBPF 프로브 — MCP 경계에서의 커널 수준 시스템 호출 모니터링

• 에이전트 매니페스트 통합 — agent.yaml을 로드하고 규정 준수(FINRA/SEC)를 정책 규칙으로 변환하며 선언되지 않은 도구 차단

• Langfuse 관측 가능성 내보내기 — LLM 수준 분석을 위해 Langfuse로 비동기 배치 내보내기

• Guardrails AI 검증 — Guardrails 허브 검증기를 통한 향상된 PII, 비밀 및 독성 감지

• MCP 서버 레지스트리 — 공식 레지스트리에서 업스트림 MCP 서버 검색, 탐색 및 검증

인과적 신뢰 그래프 (CTG) — 신규 연구 기여

• 적응형 신뢰 감쇠 — 도구/서버 신뢰도가 지수적으로 감소: T(t) = T₀ · e^{-λ(t-t₀)} · Π w(vᵢ)

• 소급적 오염 무효화 — 소스가 손상되면 모든 다운스트림 데이터가 소급적으로 오염됨

• 행동 지문 — 그래프 토폴로지 z-점수를 통해 비정상적인 도구 호출 패턴 감지

• 최소 권한 계산 — 관찰된 인과 체인에서 증명 가능한 최소 권한 도출

• 인과 체인 분석 — 모든 도구 출력을 루트 데이터 소스까지 추적

보안 보호 (MCP 사양 2025-11-25)

• 혼란스러운 대리인 방어 — 도구/서버 허용 목록을 통해 서버 간 위임 공격 방지

• 토큰 통과 가드 — 인수 및 결과 내의 자격 증명 유출(OpenAI 키, GitHub PAT, AWS 키, JWT) 차단

• SSRF 가드 — 도메인 허용 목록을 사용하여 사설 네트워크, 클라우드 메타데이터(169.254.169.254) 차단

• 세션 하이재킹 방어 — 클라이언트 지문 확인 및 만료가 포함된 HMAC 바인딩 세션

• 메모리 오염 방어 — 반복 점수를 사용하여 자기 강화 인젝션(좀비 에이전트) 감지

• 통합 보안 파이프라인 — 단일 pipeline.check_tool_call() 호출로 모든 검사 실행

규정 준수 프리셋

• 한 줄 활성화 — apply_preset("hipaa", settings)로 모든 보안 제어 구성

• 5개의 내장 프리셋 — HIPAA, SOC 2, PCI DSS v4.0, GDPR 제25조, FedRAMP High

• YAML 구성 가능 — 구성 파일에서 compliance.preset: hipaa 설정

시작하기

# Install with all backends
pip install "mcpkernel[all]"

# Start the security gateway
mcpkernel serve --host 127.0.0.1 --port 8000

MCP 클라이언트가 도구 서버를 직접 타겟팅하는 대신 http://localhost:8000/mcp를 가리키도록 설정하세요.

MCPKernel을 MCP 서버로 추가 (에이전트 호출 가능 보안 도구)

# Install into your IDE — one command
mcpkernel install claude    # Claude Desktop
mcpkernel install cursor    # Cursor IDE
mcpkernel install vscode    # VS Code + Copilot
mcpkernel install windsurf  # Windsurf
mcpkernel install zed       # Zed
mcpkernel install openclaw  # OpenClaw
mcpkernel install goose     # Goose

설치 후 에이전트는 다음과 같은 보안 도구를 기본적으로 호출할 수 있습니다:

상태 진단 실행

mcpkernel doctor

검사 항목: Python 버전, 종속성, 구성 파일 유효성, 환경 내 노출된 비밀, 도구 가용성 및 파일 권한.

설치 전 기술 스캔

# Scan a single skill
mcpkernel scan-skill path/to/SKILL.md

# Scan a directory of skills
mcpkernel scan-skill skills/ --json

감지 항목: curl|bash 파이프, rm -rf, 유출 엔드포인트, 하드코딩된 API 키, 숨겨진 지침, 선언되지 않은 환경 변수 등.

사용 사례 — 가이드 설정

1. 보안 AI 코딩 어시스