Obsidian MCP Local

MCP-сервер на Node.js + TypeScript для предоставления доступа к вашему хранилищу Obsidian для VS Code + GitHub Copilot.

Он предназначен для локального использования через stdio с упором на чтение и запись Markdown-заметок внутри вашего хранилища.

Install

npm install -g obsidian-mcp-local

Related MCP server: Obsidian MCP Server

Features

Доступные инструменты

• search_notes(query)

  • поиск текста в пути, frontmatter и содержимом заметок

  • возвращает ранжированные результаты с небольшим фрагментом текста

• get_note(path)

  • открывает заметку из хранилища

  • возвращает path, frontmatter и content

• create_note(path, content, overwrite?)

  • создает новую заметку

  • опционально перезаписывает существующую заметку

• append_to_note(path, content)

  • добавляет содержимое в конец существующей заметки

• find_by_tag(tag)

  • находит заметки по тегу

  • поддерживает tags во frontmatter и встроенные теги в содержимом

Реализованные правила

• доступ только к файлам внутри настроенного хранилища

• игнорирует такие директории, как:

  • .obsidian

  • .git

  • node_modules

• работает только с файлами .md

• нормализует пути, чтобы предотвратить доступ за пределами базовой директории

Структура проекта

obsidian-mcp-local/
  package.json
  tsconfig.json
  README.md
  .vscode/
    mcp.example.json
  src/
    index.ts

Предварительные требования

• Node.js 20+

• npm

• VS Code с GitHub Copilot

• локальное хранилище Obsidian

Установка

В директории проекта:

npm install
npm run build

Для разработки:

npm run dev

Для запуска скомпилированной версии:

npm start

Как использовать в VS Code

1. Скомпилируйте проект

npm install
npm run build

2. Настройте файл MCP в VS Code

Скопируйте содержимое .vscode/mcp.example.json в ваш .vscode/mcp.json в рабочей области, где вы будете использовать Copilot.

Пример: использование локально:

{
  "servers": {
    "obsidian-local-vault": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/caminho/para/obsidian-mcp-local/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

использование через npx (без необходимости локальной сборки):

{
  "servers": {
    "obsidian-local-vault": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp-local"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

3. Обновите пути

Замените:

• C:/caminho/para/obsidian-mcp-local/dist/index.js

• D:/Obsidian/Vault

на реальные пути на вашем компьютере.

4. Перезапустите/перезагрузите VS Code

После этого Copilot должен обнаружить MCP-сервер.

Примеры использования в Copilot Chat

• “Найди в моем хранилище заметки о .NET”

• “Открой заметку knowledge/backend/dotnet.md”

• “Создай заметку в inbox/ideias-mcp.md с кратким изложением того, что мы обсуждали”

• “Добавь в конец заметки daily/2026-04-06.md текст - протестировать локальный MCP”

• “Найди заметки с тегом #arquitetura”

Возможные будущие улучшения

• append_under_heading

• парсинг [[wikilinks]]

• get_backlinks(note)

• индекс в SQLite для быстрого поиска

• белый список папок для записи (inbox/, daily/, scratch/)

• настраиваемая блокировка записи в определенных папках

Важные замечания

• Этот проект не зависит от запущенного Obsidian.

• Он работает напрямую с файлами хранилища.

• Если вы включите запись как в Obsidian, так и в VS Code, контроль конкурентного доступа остается на ваше усмотрение.

• Проект в текущем виде предполагает, что хранилище — это локальная папка с Markdown-файлами.

Основной файл

Реализация находится в:

• src/index.ts

Лицензия

Личное использование / базовая основа для кастомизации.