Obsidian Vault MCP Server — MCP-сервер для Claude Code: что делает
Подключает AI-ассистента к хранилищу Obsidian через Local REST API. Позволяет читать заметки, искать нужные записи и работать с базой знаний прямо из чата.
claude mcp add --env API_KEY=<API_KEY> --env API_URLS=<API_URLS> --env API_HOST=<API_HOST> --env API_PORT=<API_PORT> --env MCP_TRANSPORTS=<MCP_TRANSPORTS> --transport stdio obsidian-vault-mcp-server -- npx -y @oleksandrkucherenko/mcp-obsidianЧто делает Obsidian Vault MCP Server
MCP-сервер связывает среду разработки с базой знаний в Obsidian. Вся работа идёт через плагин Local REST API. Агент получает возможность находить заметки по запросу, открывать их содержимое и обрабатывать текст в контексте текущей задачи.
Для запуска понадобятся переменные окружения API_KEY и API_URLS, которые передаются при регистрации инструмента. Также поддерживаются параметры API_HOST, API_PORT и выбор транспорта через MCP_TRANSPORTS. Пакет разворачивается с помощью npx из репозитория @oleksandrkucherenko/mcp-obsidian.
Без запущенного Obsidian с настроенным REST API сервер не сможет ответить на запросы. Поэтому ключ доступа и адрес сервиса нужно подготовить до подключения.
Какие задачи решает
- найти информацию в локальных заметках Obsidian
- прочитать содержимое файла из хранилища
- использовать контекст личной базы знаний в коде
Примеры запросов агенту
- Найди в хранилище Obsidian заметку с описанием архитектуры API.
- Прочитай файл Architecture.md из моего волта Obsidian.
- Найди все записи с упоминанием рефакторинга и перескажи ключевые тезисы.
Как установить Obsidian Vault MCP Server
Командой платформы
claude mcp add --env API_KEY=<API_KEY> --env API_URLS=<API_URLS> --env API_HOST=<API_HOST> --env API_PORT=<API_PORT> --env MCP_TRANSPORTS=<MCP_TRANSPORTS> --transport stdio obsidian-vault-mcp-server -- npx -y @oleksandrkucherenko/mcp-obsidianВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Командой платформы
codex mcp add obsidian-vault-mcp-server --env API_KEY=<API_KEY> --env API_URLS=<API_URLS> --env API_HOST=<API_HOST> --env API_PORT=<API_PORT> --env MCP_TRANSPORTS=<MCP_TRANSPORTS> -- npx -y @oleksandrkucherenko/mcp-obsidianВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"obsidian-vault-mcp-server": {
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "<API_KEY>",
"API_URLS": "<API_URLS>",
"API_HOST": "<API_HOST>",
"API_PORT": "<API_PORT>",
"MCP_TRANSPORTS": "<MCP_TRANSPORTS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"obsidian-vault-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@oleksandrkucherenko/mcp-obsidian"
],
"env": {
"API_KEY": "<API_KEY>",
"API_URLS": "<API_URLS>",
"API_HOST": "<API_HOST>",
"API_PORT": "<API_PORT>",
"MCP_TRANSPORTS": "<MCP_TRANSPORTS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e API_KEY=<API_KEY> -e API_URLS=<API_URLS> -e API_HOST=<API_HOST> -e API_PORT=<API_PORT> -e MCP_TRANSPORTS=<MCP_TRANSPORTS> obsidian-vault-mcp-server npx -y @oleksandrkucherenko/mcp-obsidianВместо <…> подставьте свои значения. Ещё 3 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Obsidian Vault MCP Server
Как установить Obsidian Vault MCP Server в Claude Code?
Выполните команду claude mcp add mcp-obsidian-via-rest -e API_KEY=<API_KEY> -e API_URLS=<API_URLS> -- npx -y @oleksandrkucherenko/mcp-obsidian, подставив свой ключ и адрес API.
Что делает Obsidian Vault MCP Server?
Сервер открывает для LLM доступ к локальному хранилищу Obsidian через Local REST API. Он помогает искать тексты и передавать содержимое заметок агенту.
Какие переменные окружения нужны для работы сервера?
Обязательно требуются API_KEY и API_URLS. При необходимости можно также задать API_HOST, API_PORT и режим MCP_TRANSPORTS.
