Mindburn-Labs/helm-ai-kernel

helm-ai-kernel은(는) 무엇을 하나요?

AI 에이전트를 위한 장애-폐쇄 실행 방화벽: MCP 도구 격리, OpenAI 호환 요청 프록시, 서명된 영수증 발행, 오프라인 EvidencePack 검증.

개요

이 프로젝트는 AI 에이전트(예: Claude Code, Cursor, Codex)의 안전한 실행을 위해 설계된 커널입니다. 주요 기능은 다음과 같습니다:

• MCP 도구 격리: 신뢰할 수 없는 MCP 도구를 샌드박스에서 실행하여 시스템 손상을 방지합니다.
• OpenAI 호환 프록시: 모든 API 요청을 가로채고 감사 로그를 기록하며, 필요시 요청을 변환합니다.
• 서명된 영수증: 각 실행에 대해 암호학적으로 서명된 영수증을 생성하여 무결성을 보장합니다.
• 오프라인 검증: 인터넷 연결 없이도 EvidencePack을 검증할 수 있는 기능을 제공합니다.

설치

npm install @mindburn/helm-ai-kernel

또는 소스에서 빌드:

git clone https://github.com/Mindburn-Labs/helm-ai-kernel.git
cd helm-ai-kernel
npm install
npm run build

사용법

import { HelmKernel } from '@mindburn/helm-ai-kernel';

const kernel = new HelmKernel({
  mode: 'fail-closed', // fail-closed 또는 fail-open
  mcpQuarantine: true,
  proxyOpenAI: {
    endpoint: 'https://api.openai.com/v1',
    apiKey: process.env.OPENAI_API_KEY,
  }
});

// AI 에이전트 실행
const result = await kernel.execute({
  agent: 'claude-code',
  prompt: '파일 시스템을 탐색해줘',
  tools: ['read-file', 'list-directory']
});

console.log(result.receipt); // 서명된 영수증

환경 변수

변수	설명	필수 여부
OPENAI_API_KEY	OpenAI API 키	예 (프록시 사용 시)
HELM_SIGNING_KEY	영수증 서명용 개인 키	아니요 (기본값 사용)
HELM_LOG_LEVEL	로그 레벨 (debug, info, warn, error)	아니요

아키텍처

[AI Agent] → [Helm Kernel] → [MCP Tools]
                   ↓
            [Signed Receipt]
                   ↓
            [EvidencePack] → [Offline Verifier]

라이선스

MIT