Obsidian MCP Server

Хранилище заметок как инструмент для LLM

MCP-сервер, который подключает хранилище Obsidian к Cursor, Claude Desktop и ChatGPT. Модель может читать, писать, искать и обходить заметки.

Архитектура · AI-системы · MCP

Problem

Хранилище Obsidian — это закрытая база знаний. LLM не могли с ним работать без локального протокола, а сетевой доступ требовал настоящей авторизации, а не открытого порта.

Role

Автор и сопровождающий

Approach

Собрал MCP-сервер на Python с двумя транспортами. stdio в Docker для десктопных клиентов. SSE и OAuth 2.1 с PKCE для ChatGPT и удалённого доступа. Инструменты на границе хранилища: ls, read, write, glob, tree, search.

Outcome

Открытый MCP-сервер, через который LLM работает с заметками как с файлами, а не как с вставленным в промпт текстом.

Хранилище Obsidian уже является структурированной базой знаний. Не хватало протокола, который LLM-клиент вызывает без вставки заметок в промпт.

Сервер отдаёт операции с хранилищем как MCP-инструменты. Десктопные клиенты подключаются через stdio в Docker. ChatGPT и удалённые клиенты — через SSE с OAuth 2.1 и PKCE. Модель читает, пишет и ищет заметки. Хранилище остаётся файловой системой, которой владеет оператор.

GitHub

Давайте делать сложное понятным.

Архитектура, инженерное лидерство и AI в разработке — когда система слишком важна, чтобы её упрощать, и слишком дорогая, чтобы ею не владеть.

LinkedIn Telegram Email