# PrimeCare MCP Hackathon Demo

> **DEMO ENVIRONMENT — SYNTHETIC DATA ONLY.** This clone refuses non-local database URLs. It must never be configured with production credentials, patient data, or external messaging or storage services.

PrimeCare MCP is an agentic clinic-operations dashboard built for the Amazon Developer Hackathon 2026. It combines a React (Vite) frontend, a Node/Express backend, and a self-hosted MCP server.

## What it demonstrates

- Material 3 queue cards with alternating blue row surfaces.
- A PrimeCare Agent page that simulates an Alexa+ interaction in the browser.
- A self-hosted MCP server at `http://127.0.0.1:4102/mcp`, using MCP Streamable HTTP.
- A read-only `primecare_clinic_flow_brief` MCP workflow that coordinates four aggregate checks: queue flow, rule-based BP follow-up review, outreach workload, and access-review workload. It never returns patient identity, contact, or clinical-note data and never makes clinical, eligibility, or security decisions.

## Requirements

- Node.js 22 or later
- npm

## Run the synthetic demo

```bash
npm run install:all
npm run demo:bootstrap --prefix backend
npm run dev
```

Open the URL printed by Vite. If another local project is already using the default ports, run the frontend with a different port and set `VITE_API_PROXY_TARGET` and `VITE_MYKAD_AGENT_BASE` to the matching local services.

Demo sign-in: `demo.admin@invalid.test` / `DemoPass2026!`. These credentials are intentionally public and work only with synthetic local data.

## Local services

`npm run dev` starts the backend, frontend, MyKad demo agent, and MCP HTTP server together. The MCP endpoint is `http://127.0.0.1:4102/mcp` by default.

To run components separately:

```bash
npm run dev:backend
npm run dev:frontend
npm run dev:mykad-agent
npm run dev:mcp-http
```

## Demo data and safety

`npm run demo:bootstrap --prefix backend` creates `backend/hackathon-demo.sqlite` locally and seeds it with synthetic data. The database is ignored by Git. Do not use production data, production credentials, or external messaging, storage, import, reconciliation, or deployment scripts in this demo clone.

To reset the demo, stop the backend and delete `backend/hackathon-demo.sqlite` plus any adjacent `-wal` and `-shm` files, then run the bootstrap command again.

## License

This project is released under the [MIT License](LICENSE).