Nucleus Mcp

.brain — ポータブルな意思決定ログ

すべてのAIツールが読み取る、ポータブルな意思決定ログ。MCP サーバーは1つ。あらゆるAIツールに対応。プレーンファイルを使用します。

AIコーディングセッションを始めるたびに、前回のセッションではすでに把握していたコンテキストを説明し直す必要があります。.brain はリポジトリ内のフォルダーで、Claude Code、Cursor、Codex がすべて1つのMCP サーバーを通じて読み取ります。意思決定、ポリシー、計画を一度書けば、あらゆるセッションとツールで記憶されます。

MITライセンスです。ファイルベース（プレーンなJSONとMarkdown）です。埋め込みベクトルは使用しません。ベンダーロックインもありません。

---

付属ツール：nucleus-rabbithole

nucleus-mcp には、2つ目の完全に独立したツール、nucleus-rabbithole も含まれています。 これは、集中が途切れやすい開発者向けの、深掘り度トラッカーです。

AIにプッシュ／ポップ式の深度スタック、コンテキストスイッチの過剰検出器、 未完了事項を外部化する機能、週次レビューを提供します。すべてローカルのSQLiteで動作し、 ネットワークもデーモンも必要ありません。

# Already installed with nucleus-mcp — just run:
nucleus-rabbithole

Claude Code の .mcp.json スニペット：

{
  "mcpServers": {
    "nucleus-rabbithole": {
      "command": "nucleus-rabbithole",
      "args": []
    }
  }
}

詳細なドキュメント：docs/RABBITHOLE.md — パッケージとともに、<site-packages>/mcp_server_nucleus/docs/RABBITHOLE.md にもインストールされます。

---

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 — 1回の呼び出しで修正できます。nucleus review は、以前の意思決定に対する評価を記録します。これがトレーニングペアとイベントになります。

COMPOUND — 差分によって、意図と現実の隔たりを測定します。繰り返し現れるパターンは戦略になり、負の差分はトレーニングシグナルになります。

すべてのツールの応答に、フロンティアの健全性が表示されます。

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

---

クイックスタート

ホステッドアクセスは現在利用できません。 リモート MCP エンドポイントは、 アクセス制御のレビューが完了するまで公開を停止しています。以下のローカルインストールを使用してください。

ローカルインストール（Cursor、Windsurf、Claude Desktop）：

pip install nucleus-mcp
nucleus init --recipe founder

コマンドは2つだけです。Nucleusが起動します。nucleus init は .brain/ の初期データを作成し、プロジェクトローカルの .mcp.json を書き込み、インストール済みのすべてのAIクライアントの設定を提案します。承認してから、クライアントを再起動してください。

nucleus build を実行するには、PATH上にコーディングエージェントのCLIが少なくとも1つ必要です。claude（npm i -g @anthropic-ai/claude-code）、devin、agy のいずれかを用意し、認証を済ませてください（claude／devin／agy のログインをそれぞれ一度行います）。いずれもない場合、build は計画段階で停止します。明確な原因がないのに build が status='error' を報告する場合、ベンダーCLI自体のエラー（ログイン期限切れなど）が .brain/relay/cross_vendor/*.json に記録されています。そこにある最新のファイルを確認してください。

---

機能

16 のファサードにまたがる 30 個の MCP ツールで、210 個のアクション、19 個の brain:// リソース、8 個のプロンプトを提供します。これらの数値は手作業で編集せず、python3 tools_audit/count_surface.py を実行して再生成してください。このスクリプトができる前は、手作業で管理していた 3 か所の数値が食い違っていました。

• GROUND — 実行検証（diff、構文、インポート、テスト、ランタイムの 5 段階）
• ALIGN — 人間による修正（判定 + 差分 + DPO + イベントを 1 回の呼び出しで実行）
• Memory — セッションをまたいで保持されるエングラム。一度書き込めば、いつでも呼び出せます。
• Sessions — コンテキストを保存し、後から再開できます。Session arc では直近 3 回のセッションを確認できます。
• Tasks — エスカレーション、HITL ゲート、ハートビート監視を備えた優先度キューです。
• Governance — キルスイッチ、コンプライアンス設定（EU DORA、MAS TRM、SOC2）、監査証跡です。
• Orchestration — エージェントスロット、複数の brain の同期、タスクのディスパッチです。
• Archive — トレーニングパイプライン（SFT + DPO）、差分の追跡、フロンティアの健全性ダッシュボードです。

ベンチマーク： decision-retention-evals — AI エージェントは、コードがそのような形になっている理由を覚えているでしょうか？（現在のミラーについては、Discord でお問い合わせください）

---

Nucleus Pro

上記の機能はすべて無料（MIT）です。Nucleus Pro では、検証可能なガバナンスが追加されます。

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

月額 $19 または 年額 $149 — nucleusos.dev/pricing

	Free	Pro
30 個のツール、19 個のリソース、8 個のプロンプト	はい	はい
永続メモリ	はい	はい
ガバナンスと HITL	はい	はい
監査証跡（DSoR）	はい	はい
署名付き監査レポート	-	まだリリースされていません
コンプライアンスエクスポート	スコアのみ	PDF/HTML 全体
優先対応の課題	-	はい

---

インストール

pip install nucleus-mcp      # or:  uvx nucleus-mcp  ·  pipx install nucleus-mcp
nucleus init                 # seeds .brain/, then offers to configure your AI clients

Python ≥3.10 が必要です。3.14 では、一部の依存関係（例：watchdog）がソースからビルドされます。3.11～3.13 では、wheel を問題なくインストールできます。init は、PATH 上で最初に見つかった nucleus バイナリを生成する設定に書き込みます。グローバルインストールが古いまま venv と併存している場合は、pipx／uvx または which nucleus を使うと、正しいバイナリが使われます。

nucleus init は必ず 3 つの処理を行います。.brain/ を初期化し、そのフォルダーで Claude Code が読み込むプロジェクトローカルの .mcp.json を書き込み、メモリへの書き込みと呼び出しのセルフテストを実行します。これにより、安心して使う前に動作を確認できます。

対話型ターミナルでは、ほかの AI クライアントも設定するかどうかを尋ねます。「はい」と答えると、インストール済みのクライアント — Claude Desktop、Claude Code、Cursor、Windsurf、Antigravity、Devin — をすべて検出し、それぞれに nucleus エントリを書き込みます。変更するファイルはすべてバックアップされます。設定したクライアント数が表示され、該当するものがない場合も、何も設定されなかったことが明確に示されます。

--no-wizard を指定するか、質問するためのターミナルがないスクリプト内で実行すると、brain とプロジェクトローカルの設定のみが初期化されます。その場合は、クライアントの設定に nucleus setup を使ってください。

その後、AI クライアントを再起動してください。確認するには、クライアントのツール一覧に nucleus_* ツールが表示されていることを確認するか、nucleus doctor を実行します。

既存の nucleus エントリは、--force を指定しない限り変更されません。ほとんどのクライアントでは、編集前に <config>.json.bak のコピーが作成されます。Claude Code の ~/.claude.json は意図的に異なる方法で処理されます。nucleus は一時ファイルに書き込んでからアトミックに置き換えるため、書き込みに失敗しても元のファイルはそのまま保たれ、隣に .bak が残ることもありません。インストール済みでも MCP 設定がまだないクライアントには設定が作成されます。インストールされていないクライアントには一切変更を加えず、~/.claude.json が存在しない場合も新たに作成されません。 すでに .brain がある場合は、nucleus setup を実行すると、再初期化せずにクライアントを設定できます。先に正確な変更内容を確認するには、--dry-run を指定してください。

Claude Desktop — ワンクリックバンドル

Claude Desktop 用のワンクリック nucleus.mcpb バンドルは、bash scripts/build_mcpb.sh でビルドできます（リリースワークフローへの対応後、リリースに添付される予定です）。Claude Desktop でバンドルを開くと、Claude に組み込まれた uv ランタイムが nucleus-mcp を取得して実行するため、Python のセットアップは不要です。

ホスト型／インストール不要のアクセス

現在利用できません。アクセス制御のレビューのため、リモート MCP エンドポイントは提供を停止しています。ローカルにインストールしてご利用ください。

手動設定（代替手段）

クライアントが自動検出されない場合は、nucleus setup --dry-run を実行して、nucleus が確認するすべての場所と、書き込まれる正確な mcpServers ブロックを表示し、そのブロックをクライアントの設定に手動で貼り付けてください。nucleus setup --create は、何も検出されない場合でも Claude Code の設定を書き込みます。詳しい手動設定手順は docs/QUICK_START.md に記載されています。このファイルは、パッケージ内の <site-packages>/mcp_server_nucleus/docs/QUICK_START.md に含まれています。

パスの検出

Nucleus は .brain を自動的に検出します。

1. NUCLEUS_BRAIN_PATH 環境変数（明示的な指定）
2. CWD から親ディレクトリをたどり、.brain/ ディレクトリを検索
3. 見つからない場合は $HOME/.nucleus/brain を使用

この検索順序は、実行中のサーバーに適用されます。nucleus init は代わりに、実行したディレクトリ（または path 引数で指定した場所）に .brain/ を作成します。別の場所に置いた brain をサーバーに検出させたい場合は、その後に NUCLEUS_BRAIN_PATH を設定してください。

---

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 をご覧ください。

---

コントリビューション

• バグを見つけましたか？ [email protected] にメールするか、Discord で報告してください
• 機能のアイデアがありますか？ Discord でご提案ください
• コードに貢献しますか？ CONTRIBUTING.md をご覧ください
• チャットしますか？ Discord

ライセンス

MIT © 2026 | [email protected]

関連リポジトリ（任意）

デプロイ環境によっては、関連スクリプトをこのリポジトリの隣にあるリポジトリに置いている場合があります。次のいずれかで、nucleus にその場所を指定してください。

export NUCLEUS_SIBLING_REPOS="$HOME/repo-a:$HOME/repo-b"     # os.pathsep-separated
# or, one path per line:
printf '%s\n' "$HOME/repo-a" "$HOME/repo-b" > ~/.config/nucleus/siblings

どちらも設定されていない場合、nucleus は自身のリポジトリのみを検索し、ホストに関する想定は行いません。スクリプトが見つからないジョブは、検索したすべての場所を示すエラーで失敗します。

プライバシー

メモリの保存先は、選択したクイックスタートのオプションによって異なります。

オプション B — ローカルインストール。 Nucleus はローカルファーストです。エングラム、メモリ、プロジェクトの状態は、お使いのマシン上の .brain/ に書き込まれます。ご自身でリレーを設定しない限り、データが外部に送信されることはありません。

オプション A — インストール不要（relay.nucleusos.dev）。 これは当社が運用するホステッドサービスです。エングラムはお使いのマシンではなく当社のサーバーに保存され、保存される内容は各メモリの完全な内容、つまりキーやタイムスタンプだけでなく value フィールドと、そのコンテキストラベル、強度、バージョン、タイムスタンプです。このモードではローカルの .brain/ は存在せず、リレーが脳の役割を果たします。

テナントは分離され、それぞれのテナントにはご自身のベアラートークンでのみアクセスできます。ただし、「ローカルファースト」という表現はオプション A には当てはまりません。この言葉でオプション A まで説明するのは誤りです。当社が運用するサーバーに置きたくない情報は、この方法で接続している間はメモリに保存しないでください。その場合はオプション B をご利用ください。

以前のこのセクションではローカルの場合のみを説明しており、リレーが受け取る内容を十分に説明できていませんでした。現在は修正済みです。

テレメトリ： 匿名の集計済み利用統計のみ（コマンド名、所要時間、エラーの種類、バージョン、OS）。エングラムの内容、ファイルパス、プロンプト、API キー、個人を特定できる情報（PII）は一切含まれません。nucleus config --no-telemetry または NUCLEUS_ANON_TELEMETRY=false で無効にできます。これは上記のどちらのオプションを選んだかとは別であり、その影響を受けません。

セルフホスト型リレー（任意、オプション B）： Nucleus の接続先に、ご自身で運用するリレーエンドポイントを指定すると、エングラムの完全な内容が同期されます。レコードの形式は上記と同じです。そのサーバーはご自身のものです。

お問い合わせ先： プライバシーに関するご質問 → [email protected]