Obsidian Scoped-write MCP

Сервис MCP для доступа к указанному хранилищу Obsidian. Весь Vault доступен для чтения; создание и обновление Markdown разрешено только в двух каталогах, предназначенных для ChatGPT:

• 00-ChatGPT系统入口

• 01-ChatGPT策略主脑

Удаление, перемещение, переименование и запись файлов, не являющихся Markdown, не предоставляются.

Инструменты

• list_directory: выводит список каталога.

• read_markdown: читает Markdown.

• search_markdown: выполняет поиск по Markdown.

• get_file_info: показывает размер, время изменения, SHA-256 и статус доступности для записи.

• create_directory: создаёт простую подпапку первого уровня внутри разрешённого каталога; родительский каталог должен уже существовать.

• create_markdown: создаёт новый файл в разрешённом каталоге; перезапись запрещена.

• update_markdown: обновляет существующий файл с использованием ожидаемого SHA-256; перед обновлением создаётся резервная копия вне Vault.

Related MCP server: mcp-fs-obsidian

Локальная проверка

npm ci
npm test

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

Границы безопасности

• Каталоги для записи определяются фиксированным белым списком на стороне сервера; параметры инструментов не могут расширить область действия.

• Создание папок разрешено только на один уровень; отказ при совпадении имени, скрытых каталогах, отсутствии родительской папки, выходе за пределы и обходе через символические ссылки.

• Отказ, если целевой объект уже существует.

• Перед обновлением сначала вызывается get_file_info, а возвращённый sha256 используется как expected_sha256; если файл изменился, обновление отклоняется.

• Перед обновлением создаётся резервная копия в локальном каталоге данных приложения текущего пользователя Windows; резервная копия не находится ни в Vault, ни в репозитории Git.

• Абсолютные пути, пути вне границ, обход через символические ссылки и файлы, не являющиеся Markdown, отклоняются.

Процесс разработки

• main всегда остаётся готовым к релизу.

• Все изменения в репозитории выполняются через короткоживущие ветки и Pull Request.

• Слияние разрешено только после прохождения CI; по умолчанию используется squash merge.

• Архитектура, границы безопасности, форматы данных, долгосрочные зависимости или крупные функции, охватывающие несколько независимых PR: родительский Issue, подпункты Issue, ADR, PR, CI и записи об откате.

• Мелкие исправления: один Issue или PR, минимальные изменения, минимальное тестирование и инструкции по откату.

Приёмка лёгких исправлений

• Приёмка: запустить npm test и выполнить слияние после прохождения проверки CI в Pull Request.

• Откат: восстановить соответствующий squash-коммит на GitHub.