中

Nucleus: macOS Life Context Server

** Дайте своему ИИ-агенту гиппокамп**

T0 - это сервер Model Context Protocol (MCP), предназначенный для объединения вашей цифровой жизни на macOS. Он позволяет агентам ИИ (например, Claude Desktop, Cursor или пользовательским агентам) безопасно читать и взаимодействовать с вашей экосистемой персональных данных.

В отличие от хрупких мостов PyObjC, Nucleus использует гибридную архитектуру: сервер Python MCP, который управляет легкими, JIT-компилированными нативными сотрудниками Swift. Это обеспечивает безопасный, эффективный и надежный доступ к собственным API Apple, оставаясь легко распространяемым через T1.

Для обзора продукта и пути настройки см. docs/introducing-nucleus.md. Скачать приложение iOS из App Store: Nucleus Context Hub

Демо-версия Terminal + MCP: Nucleus обобщает 30-дневную тенденцию восстановления из экспортируемых данных о здоровье.

Интеграция

) Доступно (текущий релиз)

*** Календарь: ** Приведите предстоящие расписания, проверьте доступность и создайте события через EventKit.

• • • • • Напоминания: * * Прочитайте отложенные задачи и управляйте списками дел через EventKit. *** Примечания:** Список/поисковые заметки, чтение контента и добавление/экспорт вложений через Notes.app (Apple Events).

中文版

⚛️ Nucleus: macOS Life Context Server

Give your AI Agent a Hippocampus.

nucleus-apple-mcp is a Model Context Protocol (MCP) server designed to unify your digital life on macOS. It allows AI agents (like Claude Desktop, Cursor, or custom agents) to securely read and interact with your personal data ecosystem.

Unlike fragile PyObjC bridges, Nucleus uses a hybrid architecture: a Python MCP server that orchestrates lightweight, JIT-compiled native Swift workers. This ensures type-safe, performant, and reliable access to Apple’s native APIs while remaining easily distributable via uvx.

For a product overview and setup path, see docs/introducing-nucleus.md. Download the iOS app from the App Store: Nucleus Context Hub.

Terminal + MCP demo: Nucleus summarizes a 30-day recovery trend from exported Health data.

🔌 Integrations

✅ Available (current release)

• 📅 Calendar: Fetch upcoming schedules, check availability, and create events via EventKit.
• ✅ Reminders: Read pending tasks and manage your to-do lists via EventKit.
• 📝 Notes: List/search notes, read content, and add/export attachments via Notes.app (Apple Events).
• ❤️ Health: Read exported Apple Health metrics and raw samples from an S3-compatible object store.

🏗 Architecture

• Python: Handles the MCP protocol, request routing, and distribution (pip/uv).
• Swift: Embedded source code acts as a “Sidecar.” It is compiled locally on the first run (using SwiftPM swift build) to interface directly with macOS private frameworks, bypassing the limitations of Python-Objective-C bridges.

📦 Swift Sidecar Layout

• Swift Package Root: src/nucleus_apple_mcp/sidecar/swift/ (includes Package.swift; CLI uses swift-argument-parser)
• Build Cache (macOS): ~/Library/Caches/nucleus-apple-mcp/sidecar//nucleus-apple-sidecar
• Optional Env Vars: NUCLEUS_APPLE_MCP_CACHE_DIR (overrides cache directory), NUCLEUS_SWIFT (swift path), NUCLEUS_SWIFTC (swiftc path)

🚀 Usage

# Run the CLI directly.
uvx --from nucleus-apple-mcp nucleus-apple health list-sample-catalog

# Or run the MCP server.
uvx nucleus-apple-mcp

🧰 CLI

Install the package once and use the unified nucleus-apple command:

uv tool install nucleus-apple-mcp

Examples:

# Calendar
nucleus-apple calendar list-events --start 2026-03-15T09:00:00+08:00 --end 2026-03-15T18:00:00+08:00 --pretty

# Reminders
nucleus-apple reminders list-reminders --due-end 2026-03-20 --pretty

# Notes