mcp-standardnotes

Предоставьте 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.

Related MCP server: claude-bridge

Возможности

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-сертификат.

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

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

• Пароль находится в оперативной памяти только во время вывода ключа. Никогда не логируется, никогда не сохраняется.

• Сессия + 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.