message-container

Docker container monorepo that reads macOS Messages (chat.db) and provides a query API, web dashboard, and MCP.

• apps/server — Bun + Hono + Drizzle API server. Mounts ~/Library/Messages read-only and incrementally syncs to its own DB (MySQL default · SQLite · PostgreSQL). Query-only (no sending)

• apps/web — Next.js (App Router) + shadcn + Tailwind v4 web dashboard. Renders data from first paint via server prefetch + Hydration, applies the flunti-otel design system (square · flat · 1px stroke)

• Security: When the initial password is set from the web, the server issues a msg_ API key, and the web stores it in an httpOnly cookie and calls the API only through a proxy

• MCP: AI clients connect to /mcp (Streamable HTTP) with the same API key

Quick start

./scripts/smoke-test.sh          # docker compose 기동 + 상태 확인 (docker 만 있으면 됨)
open http://localhost:32000       # 웹에서 초기 패스워드 설정 → 대시보드

First, you must grant Full Disk Access to Docker Desktop/OrbStack to read the actual chat.db. See docs/setup.md for detailed procedures, docs/api.md for API specs, docs/mcp.md for the MCP guide, and docs/architecture.md for the structure.

Related MCP server: iMessage MCP

Development

bun install
bun run typecheck   # 전체 워크스페이스
bun run test        # 전체 워크스페이스
(cd apps/server && bun run dev)                                  # API :33000
(cd apps/web && MESSAGE_API_URL=http://localhost:33000 bun run dev) # 웹 :32000