Skip to main content
Glama
B-HS

message-container

by B-HS

message-container

一个用于读取 macOS Messages(chat.db) 并提供查询 API、Web 仪表盘和 MCP 的 Docker 容器单体仓库。

  • apps/server — Bun + Hono + Drizzle API 服务器。以只读方式挂载 ~/Library/Messages,增量同步到自有数据库(默认 MySQL · SQLite · PostgreSQL)。仅限查询(不可发送)

  • apps/web — Next.js(App Router) + shadcn + Tailwind v4 Web 仪表盘。通过服务器预取 + Hydration 从首次绘制即渲染数据,应用 flunti-otel 设计系统(方形·扁平·1px 细线)

  • 安全:在 Web 上设置初始密码后,服务器会签发 msg_ API 密钥,Web 以 httpOnly cookie 保存,仅通过代理调用 API

  • MCP:AI 客户端使用相同的 API 密钥连接 /mcp(Streamable HTTP)

快速开始

./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