Skip to main content
Glama
deenesjakoruzh
B-HS

message-container

by B-HS
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

message-container

Монорепозиторий Docker-контейнера, который читает macOS Messages (chat.db) и предоставляет API запросов, веб-дашборд и MCP.

  • apps/server — API-сервер на Bun + Hono + Drizzle. Монтирует ~/Library/Messages в режиме read-only и выполняет инкрементальную синхронизацию в собственную БД (MySQL по умолчанию · SQLite · PostgreSQL). Только чтение (отправка невозможна)

  • apps/web — веб-дашборд на Next.js (App Router) + shadcn + Tailwind v4. Рендерит данные с первого кадра благодаря серверной предварительной загрузке + гидратации, применяет дизайн-систему flunti-otel (квадратная, плоская, 1px обводка)

  • Безопасность: при установке начального пароля в веб-интерфейсе сервер выдаёт API-ключ msg_, веб хранит его в httpOnly-куки и вызывает API только через прокси

  • MCP: AI-клиенты подключаются к /mcp (Streamable HTTP) с тем же API-ключом

Быстрый старт

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

Сначала необходимо предоставить Docker Desktop/OrbStack полный доступ к диску (Full Disk Access), чтобы можно было читать реальный chat.db. Подробная процедура — в docs/setup.md, спецификация API — docs/api.md, руководство по MCP — docs/mcp.md, архитектура — docs/architecture.md.

Related MCP server: iMessage MCP

Разработка

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • iMessage MCP Server

    sameelarif
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables reading, searching, and sending iMessages directly from MCP-compatible clients by accessing the local macOS iMessage database, supporting conversations, attachments, and both individual and group chats.
    836 npm
    10
    MIT

  • iMessage MCP

    4ndylg
    A
    license
    Not graded
    quality
    D
    maintenance
    Read-only MCP server for local macOS Messages database, enabling querying of chats, messages, attachments, and metadata.
    836 npm
    MIT

  • mac-messages

    whogben
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to read the entire Apple Messages (iMessage/SMS) history on a Mac through a read-only, batched tool that supports listing chats, retrieving transcripts, polling recent messages, and searching message bodies via REST or streamable HTTP MCP.
    MIT

  • Apple Messages MCP

    dh-repo
    A
    license
    A
    quality
    C
    maintenance
    Enables an agent to read the user's local Messages.app database on macOS, listing chats and threads and searching iMessage/SMS history entirely on localhost, with optional AppleScript sending gated behind an explicit flag. Access is read-only and scoped-shut by default, and replies can be optionally sent when send mode is enabled.
    4
    MIT