MCP Apple Notes

Сервер Model Context Protocol (MCP), который обеспечивает семантический поиск и RAG (генерацию с дополненной выборкой) по вашим заметкам Apple Notes. Работает с любым клиентом, поддерживающим MCP — Claude Desktop, Cursor, Windsurf, Cline и другими.

Возможности

• 🔍 Семантический поиск по Apple Notes с использованием локальной модели эмбеддингов all-MiniLM-L6-v2

• 📝 Возможности полнотекстового поиска

• 📂 Поддержка папок — список папок, просмотр по папкам, фильтрация поиска по папке

• 📊 Векторное хранилище на базе LanceDB

• 🤖 Работает с любым MCP-совместимым клиентом (Claude, Cursor, Windsurf, Cline и т.д.)

• 🍎 Нативная интеграция с Apple Notes через JXA

• 🔒 Опциональный режим только для чтения для безопасного изучения

• 🏃♂️ Полностью локальное выполнение — ключи API не нужны

Related MCP server: MCP Apple Notes

Безопасность и прозрачность

Поскольку этот сервер взаимодействует с вашими личными заметками Apple Notes, он разработан с учетом абсолютной прозрачности. Он работает на 100% локально на вашем Mac.

• Никакого облака, никакой телеметрии — нет ключей API, данные не покидают ваш компьютер.

• Нативный Apple JXA — использует официальный мост сценариев Apple JavaScript for Automation.

• Эмбеддинги на устройстве — модель all-MiniLM-L6-v2 работает локально через @huggingface/transformers.

• Проверяемость — настоятельно рекомендуется прочитать каждую строку кода (особенно index.ts), прежде чем он получит доступ к вашим заметкам.

• Релизы на GitHub включают контрольные суммы SHA-256, чтобы вы могли проверить загруженные артефакты.

Установка и настройка

Выберите метод установки, который подходит для вашего рабочего процесса.

Метод 1: Установка из исходного кода (рекомендуется)

Клонируя репозиторий локально, вы можете изучить исходный код и точно знать, что выполняется на вашем компьютере.

Предварительные требования: Node.js (v18+) или Bun

git clone https://github.com/Dan8Oren/mcp-apple-notes && cd mcp-apple-notes && bun install

{
  "mcpServers": {
    "apple-notes": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-apple-notes/index.ts"]
    }
  }
}

Использование NPM:

git clone https://github.com/Dan8Oren/mcp-apple-notes && cd mcp-apple-notes && npm install

Затем добавьте сервер в конфигурацию вашего MCP-клиента. Замените /path/to/mcp-apple-notes на путь, по которому вы клонировали репозиторий:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-apple-notes/index.ts"]
    }
  }
}

Совет: Хотите попробовать без риска? Включите режим только для чтения, чтобы заблокировать все операции записи во время изучения.
"env": { "MCP_APPLE_NOTES_READ_ONLY": "1" }

Метод 2: Быстрый старт через npx

Если вы предпочитаете подход без настройки и доверяете опубликованному пакету npm, вы можете просто добавить это непосредственно в свою конфигурацию MCP:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"]
    }
  }
}

После настройки перезапустите клиент и попросите своего ИИ-ассистента "index my notes" (проиндексировать мои заметки), чтобы начать.

Инструкции для конкретных клиентов

1. Откройте Settings → Developer → Edit Config

2. Вставьте выбранную JSON-конфигурацию в claude_desktop_config.json

3. Перезапустите Claude Desktop

Логи:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-apple-notes.log

# npm version:
claude mcp add apple-notes npx -- -y @dan8oren/mcp-apple-notes
# or from source:
claude mcp add apple-notes npx -- tsx /path/to/mcp-apple-notes/index.ts

Добавьте JSON-конфигурацию в ~/.cursor/mcp.json (глобально) или .cursor/mcp.json в корне вашего проекта.

Добавьте JSON-конфигурацию в ~/.windsurf/mcp.json.

Доступные инструменты

Проверка перед доверием

Каждая операция с Apple Notes — это вызов JXA, который вы можете изучить в index.ts. Никаких сетевых запросов, никакой фоновой синхронизации — только локальные вызовы моста сценариев.

Режим только для чтения

Нужна страховка? Включите режим только для чтения, чтобы заблокировать все операции записи — будут доступны только инструменты поиска, списка и чтения:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"],
      "env": { "MCP_APPLE_NOTES_READ_ONLY": "1" }
    }
  }
}

Когда этот режим включен, доступны только следующие инструменты: index-notes, list-folders, list-notes, search-notes, get-note.

Подробный режим (Verbose)

Включите подробное логирование, чтобы видеть каждый вызов JXA перед его выполнением (записывается в stderr):

Флаг CLI — добавьте --verbose в аргументы конфигурации вашего MCP-клиента:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["--verbose", "-y", "@dan8oren/mcp-apple-notes"]
    }
  }
}

Переменная окружения — для клиентов, поддерживающих env:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"],
      "env": { "MCP_APPLE_NOTES_VERBOSE": "1" }
    }
  }
}

Справочник операций JXA

Все операции проходят через мост сценариев Apple JXA (Application('Notes')). Нет прямого доступа к файловой системе, нет сетевых вызовов. Операция delete не является окончательной — заметки попадают в "Недавно удаленные" и могут быть восстановлены в течение 30 дней.

Формат ответа

Ответы инструментов представляют собой JSON-объекты в согласованном конверте:

• Успех: { "ok": true, "data": ... }

• Ошибка: { "ok": false, "error": { "type": "...", "message": "..." } }

Большинство ответов, связанных с заметками, теперь включают стабильный id Apple Notes, чтобы клиенты могли безопасно отслеживать заметки при переименовании и перемещении.

Благодарности

Изначально основано на RafalWilinski/mcp-apple-notes.