Obsidian MCP Server

Obsidian MCP Server

Obsidian MCP Server — это интеграционный слой, который соединяет приложение для заметок Obsidian с языковыми моделями и AI-агентами через Протокол Контекста Модели (MCP). Это позволяет осуществлять мощную автоматизацию, извлечение знаний и управление заметками в вашем локальном хранилище.

Author: MarkusPfundstein


Просмотреть протокол

Что такое Obsidian MCP Server?

Obsidian MCP Server — это легкий сервер, который открывает ваше локальное хранилище Obsidian и его данные для крупных языковых моделей и AI-инструментов через стандартизированный интерфейс MCP. Он использует плагин Obsidian Local REST API для безопасного взаимодействия с файлами, каталогами и содержимым заметок. Это облегчает продвинутые AI-процессы для поиска, извлечения, редактирования и управления вашими заметками.

Как настроить Obsidian MCP Server

  1. Установите плагин Obsidian Local REST API
    Скачайте и включите плагин из сообщества внутри Obsidian, затем скопируйте API-ключ из его панели конфигурации.
  2. Настройте окружение MCP Server
    a. Предпочтительно: Отредактируйте конфигурацию сервера, чтобы включить переменные окружения:
    {
      "mcp-obsidian": {
        "command": "uvx",
        "args": ["mcp-obsidian"],
        "env": {
          "OBSIDIAN_API_KEY": "<ваш_api_ключ>",
          "OBSIDIAN_HOST": "<ваш_obsidian_хост>"
        }
      }
    }
    
    b. В качестве альтернативы создайте файл .env с:
    OBSIDIAN_API_KEY=ваш_api_ключ
    OBSIDIAN_HOST=ваш_obsidian_хост
    
  3. Интегрируйте с вашей AI-средой
    Добавьте конфигурацию для Obsidian MCP Server в ваш LLM или хост агента (например, Claude Desktop), чтобы он мог подключиться к запущенному серверу.

Как использовать Obsidian MCP Server

  • Запустите Obsidian MCP Server после настройки учетных данных доступа.
  • Используйте команды на естественном языке в вашей среде LLM, чтобы запрашивать данные или выполнять действия, например:
    • "Подвести итоги последней заметки с собрания и создать новую заметку с итогами."
    • "Искать файлы, обсуждающие Azure CosmosDb."
    • "Получить содержимое файла и добавить введение."
  • LLM автоматически найдет и вызовет инструменты, предоставленные сервером Obsidian, для выполнения запрашиваемых операций.
  • Продвинутые пользователи могут напрямую вызывать конкретные инструменты, такие как перечисление файлов или редактирование содержимого заметок программно.

Ключевые функции

  • Плавное взаимодействие с вашим полным хранилищем Obsidian из LLM или AI-агентов
  • Широкий набор функций для манипуляции файлами и содержимым, включая поиск, чтение, редактирование, создание и удаление заметок
  • Безопасное и настраиваемое подключение к вашим локальным данным с аутентификацией по API-ключу
  • Гибкая интеграция с Claude Desktop и другими AI-хостами, совместимыми с MCP
  • Расширяемый: легко добавлять больше инструментов или настраивать существующие для вашего рабочего процесса

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

  • Автоматизация подведения итогов заметок с собраний и структурированных последующих заметок
  • Быстрый поиск и контекстное извлечение заметок и фрагментов знаний для быстрой справки
  • Автоматическая генерация и добавление итогов, введений или сгенерированного AI-содержимого к существующим заметкам
  • Управление и организация больших хранилищ программным образом с использованием LLM
  • Сценарирование продвинутых рабочих процессов, таких как создание ежедневных заметок, курирование базы знаний или обновления документации команды

Часто задаваемые вопросы

Q1: Нужно ли мне открывать свое полное хранилище в интернет, чтобы использовать Obsidian MCP Server?
Нет, сервер безопасно подключается к вашей локальной версии Obsidian через локальный REST API; ваше хранилище остается на вашем устройстве, если вы явно не подключаетесь к удаленным сервисам.

Q2: Безопасны ли мои данные при использовании Obsidian MCP Server с LLM?
Ваши заметки доступны только локально (или в пределах вашей указанной сети) и защищены вашим API-ключом Obsidian. Всегда проверяйте учетные данные доступа и конфигурацию сервера для безопасных развертываний.

Q3: Могу ли я использовать Obsidian MCP Server с другими языковыми моделями или инструментами, кроме Claude?
Да, любая языковая модель или платформа агента, поддерживающая MCP, может подключиться к Obsidian MCP Server и использовать его.

Q4: Что если я хочу добавить больше действий или настроить функциональность?
Сервер является расширяемым — его исходный код позволяет разработчикам добавлять пользовательские инструменты или изменять существующие, чтобы дальше настроить интеграцию.

Q5: Работает ли это с существующими плагинами и рабочими процессами Obsidian?
Да, Obsidian MCP Server действует как дополнительный уровень, получая доступ к вашим заметкам через стандартный REST API и совместим с существующими плагинами и структурами заметок.