Obsidian Turbocharged — MCP-сервер для Claude Code
MCP-сервер, через который агент читает и правит хранилище Obsidian: поиск, память и проверка опасных операций в одном канале.
claude mcp add --env OBSIDIAN_TC_CONFIG=<OBSIDIAN_TC_CONFIG> --env OBSIDIAN_TC_DEFAULT_VAULT=<OBSIDIAN_TC_DEFAULT_VAULT> --transport stdio obsidian-turbocharged -- npx -y obsidian-tcЧто делает Obsidian Turbocharged
Все обращения к хранилищу идут одним маршрутом: проверка доступа, ограничения по папкам, выключатель режима только для чтения, подтверждение человеком перед разрушительными действиями. Рядом с этим сервер держит поиск по тексту, векторам и связям между заметками, а также слой памяти в виде эпизодов с затуханием и забыванием. Память лежит в самом хранилище и подчиняется тем же ограничениям по папкам, что и остальные записи.
Быстрый старт без установки — npx obsidian-tc /path/to/vault. Тогда работают инструменты заметок и поиск по словам, а авторизация и ограничения по папкам выключены, что допустимо лишь на локальной машине. Для нескольких хранилищ и разграничения доступа нужен файл конфигурации: npm install -g obsidian-tc, затем obsidian-tc ./obsidian-tc.config.json. Нужен Node версии 24 или новее либо Bun от 1.1.
Семантический поиск опирается на модель эмбеддингов. Встроенная local при глобальной установке не ставится, её добавляют отдельно той же версии через npm install -g @the-40-thieves/obsidian-tc-embedder-local@<same version>. Ollama и внешние провайдеры обходятся без локальной модели. Без эмбеддера семантический поиск просто выключен, остальное работает.
Проект под AGPL-3.0: если вы даёте к нему сетевой доступ, условия лицензии распространяются и на ваш сервис. Для чтения одного хранилища силами одного человека хватит штатного Local REST API Obsidian — здесь же городится управление доступом и память, так что порог входа выше обычного.
Какие задачи решает
- дать агенту доступ к годам заметок, не открывая ему весь диск
- найти нужную запись по смыслу, а не только по точному слову
- держать память агента внутри хранилища под теми же ограничениями
- подтверждать удаление или перезапись заметки перед выполнением
- ограничить агенту доступ отдельными папками и вести журнал вызовов
Примеры запросов агенту
- Подключи хранилище по пути
./obsidian-tc.config.jsonи покажи, какие инструменты доступны. - Найди в моём хранилище заметки про бюджетирование за прошлый квартал.
- Запиши в память итог сегодняшнего обсуждения архитектуры, но не трогай папку
archive.
Как установить Obsidian Turbocharged
Командой платформы
claude mcp add --env OBSIDIAN_TC_CONFIG=<OBSIDIAN_TC_CONFIG> --env OBSIDIAN_TC_DEFAULT_VAULT=<OBSIDIAN_TC_DEFAULT_VAULT> --transport stdio obsidian-turbocharged -- npx -y obsidian-tcВместо <…> подставьте свои значения
Командой платформы
codex mcp add obsidian-turbocharged --env OBSIDIAN_TC_CONFIG=<OBSIDIAN_TC_CONFIG> --env OBSIDIAN_TC_DEFAULT_VAULT=<OBSIDIAN_TC_DEFAULT_VAULT> -- npx -y obsidian-tcВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"obsidian-turbocharged": {
"command": "npx",
"args": [
"-y",
"obsidian-tc"
],
"env": {
"OBSIDIAN_TC_CONFIG": "<OBSIDIAN_TC_CONFIG>",
"OBSIDIAN_TC_DEFAULT_VAULT": "<OBSIDIAN_TC_DEFAULT_VAULT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"obsidian-turbocharged": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"obsidian-tc"
],
"env": {
"OBSIDIAN_TC_CONFIG": "<OBSIDIAN_TC_CONFIG>",
"OBSIDIAN_TC_DEFAULT_VAULT": "<OBSIDIAN_TC_DEFAULT_VAULT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OBSIDIAN_TC_CONFIG=<OBSIDIAN_TC_CONFIG> -e OBSIDIAN_TC_DEFAULT_VAULT=<OBSIDIAN_TC_DEFAULT_VAULT> obsidian-turbocharged npx -y obsidian-tcВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Obsidian Turbocharged
Как установить Obsidian Turbocharged в Claude Code?
Добавьте сервер командой claude mcp add obsidian-tc -e OBSIDIAN_TC_CONFIG=<OBSIDIAN_TC_CONFIG> -- npx -y obsidian-tc. Второй вариант задаёт хранилище по умолчанию: `claude mcp add --env OBSIDIAN_TC_CONFIG=<OBSIDIAN_TC_CONFIG> --env OBSIDIAN_TC_DEFAULT_VAULT=<OBSIDIAN_TC_DEFAULT_VAULT> --transport stdio obsidian-turbocharged -- npx -y obsidian-tc`.
Что делает Obsidian Turbocharged?
Пропускает каждый вызов инструментов агента через единый шлюз с проверкой доступа и подтверждением от человека. Дополнительно даёт гибридный поиск по хранилищу и слой памяти, который хранится там же.
Нужна ли отдельная модель для семантического поиска?
Для встроенной local модель ставят пакетом той же версии, что и сервер. Ollama и внешние провайдеры эмбеддингов работают без локальной установки.
