Files
jarca-ledger-mcp/docs/batches/bat-015_20260707_docker-network-mcp-deployment/planning.md
T
Jarca 2ccfc9c064 feat: deploy jarca ledger network mcp service
- add Docker deployment for independent jarca-ledger container
- enable FastMCP streamable-http runtime configuration
- document dcy-013, REQ-019, and BAT-015 verification evidence
- update structure/runtime baselines and deployment runbook
2026-07-07 23:04:42 +09:00

1.3 KiB

BAT-015 Planning

Scope

  • Implement and verify REQ-019 Docker network MCP deployment.
  • Preserve existing stdio MCP compatibility while enabling streamable-http runtime mode.
  • Deploy jarca-ledger as an independent Docker service with Synology bind volume.
  • Migrate the existing operating DB from jarca to jarca-ledger with backup/snapshot evidence.
  • Refresh deployment runbook and baseline docs.

Design Gate

  • Required: yes
  • Rationale: this batch changes runtime topology, deployment ownership, exposed MCP transport, Docker health behavior, and operating DB location. A design/evidence trail is required even though the code diff is small.

Work plan

  1. Add MCP runtime config helpers for stdio/sse/streamable-http transport selection.
  2. Add tests for default stdio, streamable-http env config, and invalid transport rejection.
  3. Add Dockerfile, .dockerignore, compose service, healthcheck, and runbook.
  4. Build and run jarca-ledger with /volume1/docker/jarca-ledger/data:/data.
  5. Verify network MCP using a streamable-http client against http://192.168.55.253:8000/mcp.
  6. Snapshot existing jarca DB with SQLite backup API, back up the new empty DB, replace /data/ledger.sqlite3, restart, and verify table counts/integrity.
  7. Update StagePilot Discovery/SRS/BAT/baseline docs.