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（复合） — Delta（增量）衡量意图与现实之间的差距。反复出现的模式将成为策略。负向 Delta 将成为训练信号。

每个工具响应都会显示前沿健康状况：

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

快速入门

pip install nucleus-mcp
nucleus init --recipe founder

两条命令。Nucleus 即可运行。AI 输出现在已得到验证。

功能特性

涵盖 14 个方面的 114 个 MCP 工具：

GROUND — 执行验证（5 层：差异、语法、导入、测试、运行时）
ALIGN — 人工修正（一次调用即可完成判定 + Delta + DPO + 事件）
Memory — 跨会话持久化的记忆（Engrams）。一次写入，永久回溯。
Sessions — 保存上下文，稍后恢复。会话弧（Session arc）显示你最近的 3 个会话。
Tasks — 带有升级机制、人工介入（HITL）门控和心跳监控的优先级队列。
Governance — 终止开关、合规配置（EU DORA、MAS TRM、SOC2）、审计追踪。
Orchestration — 代理槽位、多大脑同步、任务调度。
Archive — 训练流水线（SFT + DPO）、Delta 追踪、前沿健康仪表盘。

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

	免费版	专业版
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

管辖区	保留期	人工介入操作	终止开关
`eu-dora`	7 年	5 种类型	必需
`sg-mas-trm`	5 年	5 种类型	必需
`us-soc2`	1 年	3 种类型	可选
`global-default`	90 天	2 种类型	可选

遥测

Nucleus 收集匿名的聚合使用统计信息（命令名称、持续时间、错误类型、版本、操作系统）。绝不包含 Engram 内容、文件路径、提示词、API 密钥或个人身份信息 (PII)。

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

详情请参阅 TELEMETRY.md。

贡献

发现 Bug？ 提交一个 Issue
有功能想法？ 发起一个 Discussion
贡献代码？ 查看 CONTRIBUTING.md
聊天？ Discord

Nucleus MCP