lab-notebook-mcp CLAUDE.md

lab-notebook-mcp

測定の一次資料を永続化する MCP サーバー。benchtop（測定）と rei-aios（理論）を つなぐ共有レイヤー。設計の詳細は docs/design.md を参照。

不変の原則（変更しないこと）

1. Append-only: 削除ツールを追加しない。訂正は supersede で表現する。
2. モードゲーティング: ro モードでは書き込みツールを登録しない。 「呼ばれてから拒否」ではなく「存在させない」。
3. 任意 SQL ツールを作らない: 必要な問い合わせは型付き専用ツールで追加する。
4. 外部由来テキストは必ず でラップする。 provenance='external' のレコードを裸で返さない。
5. 測定器に触らない: benchtop の責務。ここから機器へコマンドを送らない。
6. アーティファクトの中身を返さない: メタデータとパスのみ。

運用ルール

• run.operator にはイニシャルかハンドル名のみ。氏名を書かない。
• note.body に顧客名・契約情報・個人情報を書かない。
• 単位は experiment 内で統一する（mV と V を混在させない）。

開発

# 依存インストール (uv 使用時)
uv sync
uv run pytest

# または pip
python -m venv .venv
.venv/Scripts/activate    # Windows
# source .venv/bin/activate  # Linux/Mac
pip install -e ".[dev]"
pytest

# サーバー起動 (開発時、 rw モード)
LAB_NOTEBOOK_MODE=rw LAB_NOTEBOOK_ROOT=./_dev python -m lab_notebook

役割分担

• 本サーバー: 事実の永続化・検索・比較
• benchtop: 測定器の制御と生データ取得
• rei-aios: 仮説生成と理論構築（本サーバーへは ro でのみ接続）

Cross-pollination with Rei stack

本 project は Rei stack の 4 systems (rei-aios / benchtop / mcp-lens / rei-automator-mcp) を 5 systems 化する 拡張だが、 chat-Claude 前 turn 「+4 MCP → AI 選択劣化」 warning に 抵触しない設計:

• 責務が clean separation (benchtop=I/O, lab-notebook=永続化, rei-aios=推論)
• 各 MCP が 独立して valid (相互 HTTP/IPC 依存なし、 ID sharing のみ)
• ro モードで rei-aios 自律ループから 参照 = write 権限 は Claude Code / Cowork Claude のみ

関連 arc:

• Rei-Automator STEP 1340 audit-log.ts (2026-08-17、 hash chain primitive origin)
• benchtop v0.3.0 audit chain port (2026-08-17)
• benchtop v0.4.0 experiment notebook 統合 (2026-08-17、 本 project と 責務 overlap あり、 「quick session-level notes」 vs 「structured multi-session records」 使い分け)