Skip to main content
Glama
B-HS

message-container

by B-HS

message-container

macOS Messages(chat.db)를 읽어 조회 API·웹 대시보드·MCP 를 제공하는 Docker 컨테이너 모노레포.

  • apps/server — Bun + Hono + Drizzle API 서버. ~/Library/Messages 를 read-only 마운트해 자체 DB(MySQL 기본 · SQLite · PostgreSQL)에 증분 동기화. 조회 전용(발송 불가)

  • apps/web — Next.js(App Router) + shadcn + Tailwind v4 웹 대시보드. 서버 프리페치 + Hydration 으로 첫 페인트부터 데이터 렌더, flunti-otel 디자인 시스템(사각·플랫·1px 심) 적용

  • 보안: 웹에서 초기 패스워드를 설정하면 서버가 msg_ API 키를 발급하고, 웹은 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-rich-search

개발

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
F
license - not found
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • 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.
    207
    10
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables full-text search of macOS iMessages including link preview metadata. Works as an MCP server for Claude Desktop to search your messages locally.
    1
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Read-only MCP server for local macOS Messages database, enabling querying of chats, messages, attachments, and metadata.
    207
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    A read-only MCP server that lets AI search a user's own LINE Desktop chat history on macOS, providing tools to list chats, retrieve messages, and search conversations directly from the local encrypted database.
    5
    MIT

View all related MCP servers

Related MCP Connectors

  • Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only

  • MCP connector for iMessage & Contacts via a local Mac agent + Vercel relay

  • Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/B-HS/message-container'

If you have feedback or need assistance with the MCP directory API, please join our Discord server