Nucleus

AIの出力を毎週より信頼性の高いものにするMCPサーバー。

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

AIエージェントはハルシネーションを起こし、コードを壊し、同じ間違いを繰り返します。Nucleusはこれを捕捉します。すべてのAI出力は検証され、すべての修正が記録され、すべての間違いがシステムを学習させ、二度と繰り返さないようにします。ローカル環境で、あなたのマシン上で動作します。

3つのフロンティア

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

2つのコマンドでNucleusが起動します。これでAIの出力が検証されるようになります。

機能

14のファサードにわたる114のMCPツール：

GROUND — 実行検証（5段階：diff、構文、インポート、テスト、ランタイム）
ALIGN — 人間による修正（1回の呼び出しで判定 + デルタ + DPO + イベント）
Memory — セッション間で永続化されるエングラム。一度書き込めば、永遠に呼び出せます。
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`
Any 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 を参照してください。

貢献

バグ報告 Issue を開く
機能アイデア Discussion を開始する
コード貢献 CONTRIBUTING.md を参照
チャット Discord

Nucleus MCP