Obsidian Vault MCP (бесплатно, без карты, без постоянно включенного компьютера)

Это дает Клоду (мобильный, десктоп, веб) доступ на чтение к вашему хранилищу Obsidian через небольшой сервер, размещенный бесплатно на Render, читающий прямо из репозитория GitHub. Ваше хранилище синхронизируется с GitHub с телефона и компьютера через плагин Obsidian Git — ничего не должно оставаться включенным.

Составляющие

• Репозиторий GitHub — источник истины хранилища (бесплатный, приватный).

• Плагин Obsidian Git — автоматические коммиты/пуши/пулы с компьютера + телефона.

• Этот MCP-сервер — читает репозиторий через API GitHub, предоставляет list_notes, read_note, search_notes через MCP. Развернут бесплатно на Render.

• Graphify — опционально, запускается локально, отправляет свои результаты в репозиторий как любые другие заметки.

Related MCP server: Obsidian MCP Server

1. Создайте репозиторий GitHub

1. github.com → New repository → назовите его, например, obsidian-vault → Private → Create.

2. Settings → Developer settings → Personal access tokens → Fine-grained token:

   • Repository access: только этот репозиторий.

   • Permissions: Contents → Read and write (нужно, чтобы Клод мог создавать и редактировать заметки, а не только читать их).

   • Скопируйте токен — вы вставите его на Render как GITHUB_TOKEN.

2. Настройте Obsidian Git (компьютер + телефон)

1. Obsidian → Settings → Community plugins → обзор → установите Obsidian Git.

2. Укажите вашу папку хранилища как локальный клон репозитория (или выполните git init на месте и добавьте репозиторий GitHub как origin).

3. В настройках плагина включите auto backup on interval (например, каждые 10 мин) и auto pull on load — он будет коммитить + пушить + пулить за вас.

4. На телефоне: установите Obsidian mobile, добавьте тот же плагин (он работает на iOS/Android), войдите в GitHub на экране аутентификации плагина.

Теперь каждое устройство пушит/пулит в один и тот же репозиторий — этот репозиторий является вашим слоем синхронизации.

3. Разверните MCP-сервер на Render (бесплатно)

1. Отправьте эту папку (server.js, package.json, render.yaml) в свой собственный публичный или приватный репозиторий GitHub (отдельный от репозитория хранилища).

2. render.com → New → Web Service → подключите этот репозиторий.

3. Он должен автоматически определить render.yaml. Если нет: Build command npm install, Start command npm start, план Free.

4. Добавьте переменные окружения:

   • GITHUB_TOKEN — fine-grained токен из шага 1

   • GITHUB_OWNER — ваше имя пользователя GitHub

   • GITHUB_REPO — имя вашего репозитория хранилища (например, obsidian-vault)

   • GITHUB_BRANCH — main (или ваша ветка по умолчанию)

   • MCP_SHARED_SECRET — придумайте случайную строку; это помешает посторонним, которые найдут ваш URL на Render, читать ваше хранилище

5. Разверните. Вы получите URL вида https://obsidian-vault-mcp.onrender.com.

Примечание по бесплатному тарифу: он засыпает после ~15 мин бездействия и просыпается несколько секунд при следующем запросе — нормально для occasional запросов Клода.

4. Подключите его к Клоду

В Claude → Settings → Connectors → Add custom connector:

• URL: https://<your-app>.onrender.com/mcp

• Header: Authorization: Bearer <your MCP_SHARED_SECRET>

Затем просто попросите Клода искать, читать или редактировать ваши заметки — он будет вызывать search_notes / read_note / list_notes / write_note / delete_note автоматически. Записи коммитятся прямо в репозиторий, поэтому они появятся на вашем телефоне/компьютере при следующей синхронизации Obsidian Git (или сразу, если у вас включен auto-pull-on-interval).

Внимание при записи: write_note перезаписывает весь файл — для редактирования существующей заметки попросите Клода сначала прочитать ее, затем записать полное обновленное содержимое. delete_note — это реальный, постоянный git-коммит; стоит попросить Клода подтвердить удаление перед выполнением.

5. Graphify — автоматически, бесплатно, без хостинга

Graphify строит граф знаний из ваших заметок. Для семантического извлечения нужна LLM, и бесплатный вариант, не требующий хостинга, — это бесплатный тариф Gemini API от Google (без кредитной карты, не истекает).

Получите бесплатный ключ Gemini:

1. Перейдите на aistudio.google.com, войдите с аккаунтом Google.

2. Get API key → Create API key. Скопируйте его.

Добавьте рабочий процесс GitHub Actions:

1. В вашем репозитории хранилища создайте .github/workflows/graphify.yml с содержимым из vault-workflow/.github/workflows/graphify.yml этого проекта.

2. Repo → Settings → Secrets and variables → Actions → New repository secret:

   • Name: GEMINI_API_KEY

   • Value: ключ из AI Studio

3. Repo → Settings → Actions → General → Workflow permissions → установите в Read and write permissions (чтобы рабочий процесс мог закоммитить граф обратно).

4. Он запускается автоматически раз в день, а также при каждом пуше изменений в хранилище. Вы также можете запустить его вручную на вкладке Actions репозитория.

Это создает graphify-out/graph.json и graphify-out/GRAPH_REPORT.md в вашем репозитории хранилища — без сервера, без Space, ничего не нужно держать включенным.

MCP-сервер уже имеет для этого инструменты (graph_overview, graph_find_node, graph_neighbors) — они читают граф прямо из GitHub так же, как read_note. Ничего дополнительно разворачивать не нужно; просто повторно разверните обновленный server.js на Render, и они появятся при следующем подключении Клода.

Локальное тестирование (опционально, перед развертыванием)

npm install
GITHUB_TOKEN=xxx GITHUB_OWNER=you GITHUB_REPO=obsidian-vault npm start

Затем POST к http://localhost:3000/mcp с MCP-клиентом, или просто разверните напрямую на Render и протестируйте через Клода.