LineLedger — Factory-Floor Co-pilot

A voice-first assistant for a plant manager or line operator, backed by a self-hosted Model Context Protocol (MCP) server over Streamable HTTP. Built for the Build, Ship, Shape: Amazon Developer Hackathon (Alexa+ track).

Status: Phase 0 scaffold. There is no runnable application yet. This README only lists commands that have been run. Setup and run instructions will be added as each phase is verified.

Demo data disclosure

All production, handover and purchasing records in this project are synthetic demo data. Nothing is connected to a real factory, real inventory or real customers. The project does not monitor live equipment and does not integrate with a physical Alexa+ device.

Related MCP server: Nordic Thingy:52 MCP Server

Zero-cost, local-first

The project is built and demoed without any paid service. It makes no calls to cloud APIs and needs no cloud credentials. The language model, when used, runs locally.

Planned architecture

• server/: TypeScript MCP server (@modelcontextprotocol/sdk 1.32.1, Express, zod, node:sqlite).

• packages/container-load/: standalone, MIT-licensed container-load calculation library.

• web/: Vite + vanilla TypeScript client with a live MCP trace panel and shift dashboard.

• agent/: small Python service (Strands Agents SDK with a local Ollama model), with a deterministic rule-based planner as fallback.

• docs/: UI specification, implementation decisions, product feedback and friction log.

See docs/implementation-decisions.md for the verified versions and the reasoning, and docs/ui-spec.md for the design system.

Verified so far

node -v      # v22.23.3
node -e "const {DatabaseSync}=require('node:sqlite'); const d=new DatabaseSync(':memory:'); d.exec('create table t(a)'); d.prepare('insert into t values (?)').run(1); console.log(d.prepare('select a from t').all().length); d.close()"
# prints 1 (Node 22 prints an ExperimentalWarning for node:sqlite)

License

MIT. See LICENSE.