Nucleus

매주 AI 결과물의 신뢰성을 높여주는 MCP 서버.

PyPI version License: MIT MCP Compatible NPM nucleus-mcp MCP server

AI 에이전트는 환각을 일으키고, 코드를 망가뜨리며, 실수를 반복합니다. Nucleus는 이를 포착합니다. 모든 AI 결과물은 검증되고, 모든 수정 사항은 기록되며, 모든 실수는 시스템이 이를 반복하지 않도록 학습시킵니다. 로컬 머신에서 말이죠.

세 가지 프런티어

AI 신뢰성이 시간이 지남에 따라 복합적으로 향상되는 핵심 루프:

  GROUND              ALIGN               COMPOUND
  ──────              ─────               ────────
  Machine verifies    Human corrects      System learns

  AI writes code  →  You fix a mistake →  Delta recorded
  GROUND checks   →  Verdict stored    →  DPO pair created
  Receipt logged  →  Event emitted     →  Training data grows
       │                   │                    │
       └───────────────────┴────────────────────┘
                    Reliability improves

GROUND(기반) — 5단계 실행 검증. 구문, 임포트, 테스트, 런타임. 공식 시스템 외부로 나가 AI의 작업을 확인합니다.

ALIGN(정렬) — 원콜 수정. nucleus_align(action="correct", params={context, correction}). 각 수정 사항은 자동으로 판정을 기록하고, 학습 쌍을 생성하며, 이벤트를 발생시킵니다.

COMPOUND(복합) — 델타는 의도와 현실 사이의 간극을 측정합니다. 반복되는 패턴은 전략이 됩니다. 부정적인 델타는 학습 신호가 됩니다.

모든 도구 응답은 프런티어 상태를 보여줍니다:

[frontiers: GROUND 42 | ALIGN 12 | COMPOUND 28]

빠른 시작

pip install nucleus-mcp
nucleus init --recipe founder

두 개의 명령어. Nucleus가 실행됩니다. 이제 AI 결과물이 검증됩니다.

주요 기능

14개 파사드에 걸친 114개의 MCP 도구:

GROUND — 실행 검증 (5단계: diff, 구문, 임포트, 테스트, 런타임)
ALIGN — 인간의 수정 (한 번의 호출로 판정 + 델타 + DPO + 이벤트)
Memory — 세션 간 지속되는 엔그램(Engram). 한 번 기록하면 영원히 기억합니다.
Sessions — 컨텍스트 저장 및 나중에 재개. 세션 아크는 최근 3개의 세션을 보여줍니다.
Tasks — 에스컬레이션, HITL(인간 개입) 게이트, 하트비트 모니터링이 포함된 우선순위 큐.
Governance — 킬 스위치, 규정 준수 구성(EU DORA, MAS TRM, SOC2), 감사 추적.
Orchestration — 에이전트 슬롯, 멀티 브레인 동기화, 작업 배포.
Archive — 학습 파이프라인(SFT + DPO), 델타 추적, 프런티어 상태 대시보드.

Nucleus Pro

위의 모든 기능은 무료(MIT)입니다. Nucleus Pro는 검증 가능한 거버넌스를 추가합니다:

nucleus trial                              # 14-day free trial
nucleus compliance-check                   # Score your AI governance
nucleus audit-report --signed -o report.html  # Cryptographically signed report

월 $19 또는 연 $149 — nucleusos.dev/pricing

	무료	Pro
12개 도구, 8개 리소스, 3개 프롬프트	예	예
영구 메모리	예	예
거버넌스 및 HITL	예	예
감사 추적 (DSoR)	예	예
서명된 감사 보고서	-	Ed25519
규정 준수 내보내기	점수만	전체 PDF/HTML
우선순위 이슈	-	예

설치

원클릭

IDE	설치
Cursor	Cursor에 추가
Claude Code	`npx -y nucleus-mcp`
모든 IDE	`pip install nucleus-mcp`

pip / npx

pip install nucleus-mcp

또는 npx를 사용하세요 (Python 설정 불필요):

npx -y nucleus-mcp

MCP 클라이언트 구성

Claude Desktop / Cursor / Windsurf

MCP 구성(claude_desktop_config.json 또는 동등한 파일)에 추가하세요:

{
  "mcpServers": {
    "nucleus": {
      "command": "npx",
      "args": ["-y", "nucleus-mcp"]
    }
  }
}

{
  "mcpServers": {
    "nucleus": {
      "command": "python3",
      "args": ["-m", "mcp_server_nucleus"],
      "env": {
        "NUCLEAR_BRAIN_PATH": "/path/to/your/project/.brain"
      }
    }
  }
}

Claude Code

프로젝트 루트의 .mcp.json에 추가하세요:

{
  "mcpServers": {
    "nucleus": {
      "command": "npx",
      "args": ["-y", "nucleus-mcp"]
    }
  }
}

경로 탐색

Nucleus는 .brain을 자동으로 찾습니다:

NUCLEAR_BRAIN_PATH 환경 변수 (명시적)
CWD에서 상위로 이동하며 .brain/ 디렉토리 탐색
$HOME/.nucleus/brain으로 폴백

CLI

Nucleus는 MCP 도구와 함께 전체 CLI를 제공합니다. TTY(테이블 출력)와 파이프(JSON)를 자동 감지합니다.

# Memory
nucleus engram write my_key "insight here" --context Decision --intensity 7
nucleus engram search "compliance"
nucleus engram query --context Strategy --limit 10

# Tasks
nucleus task list --status READY
nucleus task add "Ship the feature" --priority 1

# Sessions
nucleus session save "Working on auth refactor"
nucleus session resume

# Health
nucleus status --health
nucleus sovereign

# Compliance
nucleus comply --jurisdiction eu-dora
nucleus audit-report --format html -o report.html

# Chat (multi-provider: Gemini, Anthropic, Groq)
nucleus chat

파이프 친화적:

nucleus engram search "test" | jq '.key'
nucleus task list --format tsv | cut -f1,3

규정 준수

규제 프레임워크를 위한 원명령어 구성:

nucleus comply --jurisdiction eu-dora       # EU DORA
nucleus comply --jurisdiction sg-mas-trm    # Singapore MAS TRM
nucleus comply --jurisdiction us-soc2       # US SOC2

관할권	보존 기간	HITL 운영	킬 스위치
`eu-dora`	7년	5가지 유형	필수
`sg-mas-trm`	5년	5가지 유형	필수
`us-soc2`	1년	3가지 유형	선택
`global-default`	90일	2가지 유형	선택

텔레메트리

Nucleus는 익명의 집계된 사용 통계(명령어 이름, 지속 시간, 오류 유형, 버전, OS)를 수집합니다. 엔그램 콘텐츠, 파일 경로, 프롬프트, API 키, 개인 식별 정보(PII)는 절대 수집하지 않습니다.

nucleus config --no-telemetry
# or: NUCLEUS_ANON_TELEMETRY=false

자세한 내용은 TELEMETRY.md를 참조하세요.

기여

버그인가요? 이슈를 열어주세요.
기능 아이디어가 있나요? 토론을 시작하세요.
코드 기여? CONTRIBUTING.md를 확인하세요.
채팅? Discord

Nucleus MCP