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)
- Append-only: 削除ツール なし、 訂正は supersede
- モード gating:
roでは 書き込み tool を 登録自体しない + SQLite ro URI で 二重防御 - 任意 SQL 禁止:
execute_sql系 意図的に 提供しない - 外部由来テキスト は でラップ: prompt injection 対策
- 測定器に触らない: benchtop の責務、 本 server は DB layer のみ
- アーティファクト中身返さない: メタデータ + 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 で 永続化、 professionallab 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 参照時に 決定)。
