lab-notebook-mcp

Version: 0.1.0 (Phase 1、 2026-08-17)

測定の一次資料を永続化する MCP サーバー。 chat-Claude 2026-08-17 「新しいアイデア」 arc の 「実験ノート MCP」 提案を independent MCP として 実装。 設計詳細は docs/design.md 参照。

Design 原則 (§5 セキュリティ設計 + §3.4 append-only)

1. Append-only: 削除ツール なし、 訂正は supersede
2. モード gating: ro では 書き込み tool を 登録自体しない + SQLite ro URI で 二重防御
3. 任意 SQL 禁止: execute_sql 系 意図的に 提供しない
4. 外部由来テキスト は <external-content> でラップ: prompt injection 対策
5. 測定器に触らない: benchtop の責務、 本 server は DB layer のみ
6. アーティファクト中身返さない: メタデータ + path のみ

Quick start

pip install -e ".[dev]"
pytest                     # 全 test 通過確認
LAB_NOTEBOOK_MODE=rw LAB_NOTEBOOK_ROOT=./_dev python -m lab_notebook

Env vars

Var	Default	説明
LAB_NOTEBOOK_ROOT	$HOME/lab-notebook	DB + artifacts 保存先
LAB_NOTEBOOK_MODE	ro	ro (default 安全側) or rw
LAB_NOTEBOOK_INGEST_DIRS	(unset)	artifact 取り込み許可 dir (: 区切り)、 unset なら 取り込み拒否

Cross-pollination 関連 (Rei stack)

• benchtop v0.4.0 (2026-08-17): 実験ノート features (subject/env/mystery_id + find_similar_sessions + regression_check) が 本 project と responsibility overlap。 使い分け 推奨:
  • benchtop v0.4.0: quick session-level notes (単発 session に メタデータ付ける)
  • lab-notebook-mcp: structured multi-session records (experiment × run × dut × condition × measurement × artifact × baseline を SQL schema で 永続化、 professional lab notebook 用途)
• Rei-Automator STEP 1340 audit-log.ts (2026-08-17): hash chain primitive origin、 本 project は SQLite WAL + append-only + supersede で 別方式 の integrity 保証

Repository

• GitHub: https://github.com/fc0web/lab-notebook-mcp
• Related: https://github.com/fc0web/benchtop-mcp (measurement I/O 姉妹 project)
• Rei stack site page: https://rei-aios.pages.dev/tools/lab-notebook-mcp-phase1-arc-2026-08-17/

License

MIT (v0.x)。 v1.0+ での license 切替の 可能性 あり (LICENSE file 参照時に 決定)。