mcp-standardnotes

License: MIT Node: ≥20

Предоставьте Claude безопасный доступ на чтение/запись к вашему хранилищу Standard Notes — сквозное шифрование, только локальный stdio, никаких посредников в облаке.

Попросите Claude обобщить ваши заметки, составить черновики новых, упорядочить теги, выполнить поиск по всему хранилищу — и все это при том, что ваш мастер-ключ остается на вашем компьютере. Работает с Claude Code, Claude Desktop и любым клиентом, совместимым с MCP.

Отказ от ответственности. Это неофициальная сторонняя интеграция. Не связана, не одобрена и не спонсируется Standard Notes Ltd. "Standard Notes" является торговой маркой Standard Notes Ltd.

Почему это нужно

🔒 Сквозное шифрование. Вся расшифровка происходит локально с использованием проверенных примитивов libsodium (Argon2id + XChaCha20-Poly1305 IETF). Ваш пароль никогда не покидает оперативную память; ваш мастер-ключ никогда не покидает ваш компьютер.
🔌 Только локальный stdio. Этот сервер никогда не открывает сетевые порты.
🔑 Системная связка ключей для хранения сессий. macOS Keychain, Linux libsecret, Windows Credential Vault — никаких файлов в открытом виде.
☁️ Работает с официальными облачными или self-hosted серверами Standard Notes.

Возможности

Инструмент	Что он делает
`notes_list` / `notes_search` / `notes_get`	Просмотр и поиск заметок (фильтрация по тегу с помощью `tag: "<uuid-or-title>"`)
`notes_create` / `notes_update` / `notes_delete`	Создание заметок (markdown, super, code, rich-text, task, spreadsheet, plain-text)
`notes_create_many`	Пакетное создание до 50 заметок за одну синхронизацию
`notes_stats`	Статистика хранилища: количество, размеры, самая старая/новая/большая заметка
`tags_list` / `tags_get` / `tags_create` / `tags_update` / `tags_delete`	Полный CRUD тегов
`tags_attach` / `tags_detach`	Привязка/отвязка тегов к заметкам
`sync`	Принудительная синхронизация с сервером

notes_create и notes_update принимают необязательный параметр tags: string[] (UUID тегов) для привязки тегов во время записи.

Требования

Node.js ≥ 20
Учетная запись Standard Notes с протоколом 004 (по умолчанию для любой учетной записи, созданной или обновленной после 2020 года)
macOS, Linux или Windows с работающей системной связкой ключей

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

1. Установка

npm install -g mcp-standardnotes

Или запустите из клонированного репозитория, если предпочитаете:

git clone https://github.com/lozit/mcp-standardnotes.git
cd mcp-standardnotes
npm install && npm run build

2. Однократный вход

mcp-standardnotes-login         # if installed globally
# or, from a clone:
npm run login

Вас попросят ввести email и пароль. Пароль используется для получения мастер-ключа в памяти (Argon2id) и никогда не записывается на диск. Зашифрованная сессия сохраняется в системной связке ключей; последующие запуски используют ее автоматически.

3. Подключение к Claude

Claude Code — добавьте в ~/.claude.json или .mcp.json:

{
  "mcpServers": {
    "mcp-standardnotes": {
      "type": "stdio",
      "command": "mcp-standardnotes",
      "env": { "SN_EMAIL": "you@example.com" }
    }
  }
}

Если вы клонировали репозиторий вместо npm install -g, замените command на абсолютный путь к node и добавьте args: ["/absolute/path/to/mcp-standardnotes/dist/index.js"].

Затем используйте /mcp для переподключения.

Claude Desktop (macOS) — отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json с той же структурой и используйте абсолютный путь к вашему бинарному файлу Node ≥ 20 (Claude Desktop не наследует nvm). См. docs/troubleshooting.md, если возникнет ошибка SyntaxError: Unexpected token '??='.

Любой другой MCP-клиент — запустите node dist/index.js с установленной переменной окружения SN_EMAIL. Транспорт — stdio.

Используете свой сервер Standard Notes? См. docs/self-hosted.md для рецепта docker-compose и информации о том, как закрепить ваш TLS-сертификат.

Конфигурация

Переменная	По умолчанию	Описание
`SN_EMAIL`	обязательно	Email вашей учетной записи SN. Должен совпадать с тем, что вы использовали при `npm run login`.
`SN_SERVER_URL`	`https://api.standardnotes.com`	URL сервера синхронизации. Измените для self-hosted экземпляров.
`KEYCHAIN_SERVICE`	`mcp-standardnotes`	Переопределение имени службы связки ключей (полезно для нескольких учетных записей).
`SN_CERT_FINGERPRINT`	не задано	SHA-256 отпечаток TLS-сертификата для self-hosted серверов (64 шестнадцатеричных символа, двоеточия опциональны). См. docs/self-hosted.md.

Безопасность вкратце

Пароль находится в оперативной памяти только во время вывода ключа. Никогда не логируется, никогда не сохраняется.
Сессия + hex-код мастер-ключа → только в системной связке ключей. Никаких файлов в открытом виде.
Только транспорт stdio. Никаких HTTP-портов.
Все логи направляются в stderr и проходят через фильтр, который маскирует пароли, ключи, JWT и токены.
Все входные данные инструментов проверяются с помощью zod.
Уязвимости HIGH/CRITICAL в npm audit блокируют слияние в CI.
Локально реализован только фрейминг протокола 004; все криптографические примитивы взяты из libsodium-wrappers-sumo.

Полная модель угроз и подробный разбор: docs/protocol-004.md.

Устранение неполадок

Распространенные проблемы и их решения: docs/troubleshooting.md.

Выход из системы

SN_EMAIL=you@example.com mcp-standardnotes-logout
# or, from a clone:
SN_EMAIL=you@example.com npm run logout

Дорожная карта

Предстоящие задачи отслеживаются в ROADMAP.md.

Вклад в проект

Приветствуются любые вклады. См. CONTRIBUTING.md для настройки, тестов и чек-листа PR.

Лицензия

MIT — используйте, форкайте, выпускайте.

Авторы

Standard Notes за дизайн шифрования и публичный API.
Model Context Protocol и Anthropic за SDK MCP.
libsodium от Фрэнка Дениса, представленный через libsodium-wrappers-sumo.

Standard Notes