# Obsidian MCP Server

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

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20 у репозитория
- Автор: maxkuminov
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/maxkuminov/obsidian-mcp
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/maxkuminov-obsidian-mcp-server

## Что делает

Сервер открывает MCP-клиентам доступ к Markdown-файлам в хранилище Obsidian. Агент может искать заметки по ключевым словам и смыслу, учитывать wikilinks и работать с графом связей. Записи остаются обычными файлами: их можно читать и править в Obsidian.

При записи сервер проверяет `expected_hash`, чтобы отклонить изменение, основанное на устаревшем чтении. Публикация проходит атомарно, удалённые файлы попадают в `.trash/`, а `dry_run` показывает diff до применения. Для работы заявлен стек Python 3.12, FastAPI и PostgreSQL с pgvector. Это self-hosted сервер, поэтому его нужно развернуть и настроить подключение клиента; при работе через Claude Code в README приведён HTTP-вариант с токеном авторизации.

## Требования
- Нужно: Docker
- Переменные окружения: `DATABASE_URL`, `VAULT_PATH`, `SECRET_KEY`, `MCP_HOSTNAME`, `EMBEDDING_PROVIDER`, `OLLAMA_URL`, `OPENAI_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.
- Работает с: Obsidian

## Установка

### Claude Code (родная платформа)

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- искать заметки по смыслу и ключевым словам
- находить связанные записи через wikilinks
- хранить память агента в Markdown-файлах хранилища
- сохранять правки с проверкой устаревшего чтения

## Примеры запросов агенту
- Найди в моём хранилище заметки о текущем проекте и связанные с ними страницы.
- Сохрани итоги этой сессии в подходящую заметку Obsidian.
- Покажи diff будущего изменения заметки, не применяя его.

## Похожие
- [obsidian-headless](https://affpapa.org/nevibecode/skills/obsidian-headless.md) — скилл · 1200 установок
- [obsidian-markdown](https://affpapa.org/nevibecode/skills/agricidaniel-obsidian-markdown.md) — скилл · 593 установки
- [obsidian-kb-artifacts](https://affpapa.org/nevibecode/skills/obsidian-kb-artifacts.md) — скилл · 328 установок
- [obsidian](https://affpapa.org/nevibecode/skills/julianobarbosa-obsidian.md) — скилл · 244 установки
- [obsidian-mcp-server](https://affpapa.org/nevibecode/mcp/obsidian-mcp-server.md) — MCP-сервер · ★ 715 у репозитория
- [Engram: AI memory you can edit in Obsidian](https://affpapa.org/nevibecode/mcp/engram-ai-memory-you-can-edit-in-obsidian.md) — MCP-сервер · ★ 2 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
