Для чего этот сервер?

Этот сервер соединяет AI-помощников с хранилищем Obsidian. Он позволяет Claude, ChatGPT и другим моделям искать заметки, читать их и анализировать связи между ними, даже если в запросе опечатки. Так AI получает прямой доступ к личной базе знаний пользователя и может отвечать на вопросы на основе его записей, находить потерянные файлы или выполнять Dataview-запросы — без копирования текста вручную.

Что он умеет?

Ищет заметки по текстовому запросу и через нечёткий поиск, который находит файлы даже с опечатками, читает содержимое конкретных файлов, выполняет Dataview-запросы по метаданным заметок, показывает список файлов и папок в указанном каталоге хранилища, анализирует связи между заметками: строит граф ссылок, находит заметки без связей и выявляет взаимосвязи. Нечёткий поиск и анализ связей работают без Obsidian API.

Каталог MCP
louis030195/easy-obsidian-mcp

louis030195/easy-obsidian-mcp

от louis030195

MCP-сервер для подключения AI-ассистентов (Claude, ChatGPT) к Obsidian: поиск, чтение и анализ связей между заметками. Полезен для пользователей Obsidian, которые хотят задействовать ИИ для работы ...

Github NPM Сайт сервера

README

6 инструментов

Версии

Установить сервер

Obsidian MCP Server

Connect Claude, ChatGPT, and other AI assistants to your Obsidian vault.

💖 Support This Project

If you find this MCP server useful, please consider supporting its development!

👉 Click here to support this project

Your support helps maintain and improve this tool. Thank you! 🙏

Quick Start

1. Install in your AI app

Claude Desktop: Add to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@louis030195/mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code:

claude mcp add obsidian "npx -y @louis030195/mcp-obsidian" -s user -e OBSIDIAN_API_KEY="your-api-key-here"

2. Enable Obsidian API (Optional - for full features)

Open Obsidian → Settings → Community plugins
Turn off Restricted mode → Search "Local REST API" → Install & Enable

Copy the API key and add to your config:

"env": {
  "OBSIDIAN_API_KEY": "your-api-key-here"
}

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

Инструменты были проиндексированы: 21.10.2026

obsidian_dataview_search

Выполняет запрос на языке Dataview Query Language (DQL). DQL: мощный язык, похожий на SQL, для запросов к заметкам Obsidian на основе метаданных (frontmatter, inline-поля), тегов, папок, ссылок, свойств файлов (имя, путь, даты) и задач. Используйте его, чтобы фильтровать, сортировать, группировать и преобразовывать данные из своего хранилища. Ключевое отличие от SQL: DQL выполняет запросы последовательно, строка за строкой, передавая результаты между командами. Это позволяет использовать несколько шагов where, sort или group by, в отличие от декларативного SQL. Поиск людей/имен: - поиск по названиям заметок: table file.name where contains(file.name, "ben") - найти заметки, ссылающиеся на человека: list from [[Ben]] - поиск по тегу человека: list from #person/ben Частые шаблоны: - получить метаданные заметки: table file.name, file.mtime from "NOTENAME" - поиск по тегу: list from #tag - поиск в папке: list from "folder/" - обратные ссылки: list from [[FILENAME]] - все заметки: list from "" Этот инструмент особенно хорош для поиска связей между заметками, метаданных и структурированных запросов. Используйте его, когда простой текстовый поиск не находит нужное. Полный синтаксис см. в документации Dataview: https://blacksmithgu.github.io/obsidian-dataview/

Параметры

querystringобязательный
Строка запроса на языке запросов Dataview (DQL). примеры для поиска людей/имён: - поиск по заголовкам заметок: "table file.name where contains(file.name, "ben")" - поиск обратных ссылок: "list from [[Ben]]" - поиск по тегам: "list from #person" - все заметки: "list from """ типовые шаблоны: - список всех заметок: "list from """ - получить конкретную заметку: "table file.name, file.mtime from "NOTENAME"" - найти заметки по тегу: "list from #tag" - заметки в папке: "list from "folder/"" - заметки со ссылками на файл: "list from [[FILENAME]]" полный синтаксис: https://blacksmithgu.github.io/obsidian-dataview/

obsidian_fuzzy_search

нечёткий поиск заметок с использованием приблизительного сопоставления. работает даже когда недоступен Obsidian API. отлично подходит для поиска заметок, если вы не уверены в точном написании или формулировке.

Параметры

max_resultsnumber
Максимальное количество возвращаемых результатов (по умолчанию: 10).
querystringобязательный
Поисковый запрос для нечёткого сопоставления

obsidian_get_file_content

Извлекает полное содержимое конкретного файла из Obsidian Vault.

Параметры

filepathstringобязательный
путь к файлу относительно корня хранилища (например, 'notes/my important note.md')

obsidian_graph_search

Анализирует ссылки и связи между заметками. Находит заметки-сироты, строит графы ссылок и обнаруживает взаимосвязи заметок. Работает без Obsidian API.

Параметры

include_orphansboolean
Включает заметки без ссылок (по умолчанию: false)
max_depthnumber
Максимальная глубина обхода соединений (по умолчанию: 2)
start_filestring
Необязательный исходный файл для анализа связей.

obsidian_list_files

Перечисляет файлы и папки в указанной директории в хранилище Obsidian. Если директория не указана, перечисляет элементы в корне хранилища.

Параметры

directory_pathstring
Необязательный путь к каталогу относительно корня хранилища (например, 'projects/active'). Если не указан, выводит список файлов и папок в корне хранилища.
max_itemsnumber
Максимальное количество возвращаемых элементов (по умолчанию: 50, максимум: 100). Помогает предотвратить переполнение токенов в больших каталогах.
offsetnumber
Количество элементов, которые нужно пропустить для постраничного вывода (по умолчанию: 0). Используйте вместе с max_items для пролистывания больших каталогов.
sort_byenum
Критерий сортировки результатов (по умолчанию: 'name')
sort_orderenum
Порядок сортировки результатов (по умолчанию: 'asc')

obsidian_simple_search

Простой поиск документов, соответствующих заданному текстовому запросу, по всем файлам в хранилище. Используйте этот инструмент, когда хотите выполнить простой текстовый поиск

Параметры

context_lengthnumber
Сколько контекста возвращать вокруг совпавшей строки (по умолчанию: 100, максимум: 2000)
max_resultsnumber
Максимальное количество результатов для возврата (по умолчанию: 20, максимум: 100). Помогает предотвратить переполнение токенов.
offsetnumber
Число результатов, которые нужно пропустить при постраничной навигации (по умолчанию: 0). Используйте вместе с max_results для постраничного перебора результатов.
querystringобязательный
Текст для поиска в хранилище. Ищет по всему содержимому файлов. Без учёта регистра.

`1.1.3`основная	02.10.2025
`1.1.2`	24.09.2025
`1.1.1`	24.09.2025
`1.1.0`	13.09.2025
`1.0.0`	13.09.2025

Выберите клиент, чтобы установить louis030195/easy-obsidian-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "louis030195-easy-obsidian-mcp-v9jb27gaqo": {
      "command": "npx",
      "args": [
        "-y",
        "@louis030195/mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "louis030195-easy-obsidian-mcp-v9jb27gaqo": {
      "command": "npx",
      "args": [
        "-y",
        "@louis030195/mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "louis030195-easy-obsidian-mcp-v9jb27gaqo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@louis030195/mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"louis030195-easy-obsidian-mcp-v9jb27gaqo\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@louis030195/mcp-obsidian\"],\"env\":{\"OBSIDIAN_API_KEY\":\"your-api-key-here\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "louis030195-easy-obsidian-mcp-v9jb27gaqo": {
      "command": "npx",
      "args": [
        "-y",
        "@louis030195/mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add louis030195-easy-obsidian-mcp-v9jb27gaqo --env OBSIDIAN_API_KEY=your-api-key-here -- npx -y @louis030195/mcp-obsidian

Либо через JSON-конфиг:

claude mcp add-json louis030195-easy-obsidian-mcp-v9jb27gaqo "{\"command\":\"npx\",\"args\":[\"-y\",\"@louis030195/mcp-obsidian\"],\"env\":{\"OBSIDIAN_API_KEY\":\"your-api-key-here\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add louis030195-easy-obsidian-mcp-v9jb27gaqo --env OBSIDIAN_API_KEY=your-api-key-here -- npx -y @louis030195/mcp-obsidian

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.louis030195-easy-obsidian-mcp-v9jb27gaqo]
command = "npx"
args = ["-y", "@louis030195/mcp-obsidian"]

[mcp_servers.louis030195-easy-obsidian-mcp-v9jb27gaqo.env]
OBSIDIAN_API_KEY = "your-api-key-here"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите louis030195/easy-obsidian-mcp, а в поле команды запуска — строку ниже:

npx -y @louis030195/mcp-obsidian

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "louis030195-easy-obsidian-mcp-v9jb27gaqo": {
      "command": "npx",
      "args": [
        "-y",
        "@louis030195/mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "louis030195-easy-obsidian-mcp-v9jb27gaqo": {
      "command": "npx",
      "args": [
        "-y",
        "@louis030195/mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например louis030195-easy-obsidian-mcp-v9jb27gaqo.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: louis030195-easy-obsidian-mcp-v9jb27gaqo
    command: npx
    args:
      - "-y"
      - "@louis030195/mcp-obsidian"
    env:
      OBSIDIAN_API_KEY: your-api-key-here

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "louis030195-easy-obsidian-mcp-v9jb27gaqo": {
      "command": "npx",
      "args": [
        "-y",
        "@louis030195/mcp-obsidian"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@louis030195/mcp-obsidian"
  ],
  "env": {
    "OBSIDIAN_API_KEY": "your-api-key-here"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 17
Форков на Github: 4
Загрузок: 558
Язык реализации: TypeScript
Лицензия: неизвестно
Официальный сервер: Нет
Дата обновления данных: 21.10 в 05:02
Идентификатор: CYwzerWa7tw7Z0uC
Категории: Заметки

louis030195/easy-obsidian-mcp

Obsidian MCP Server

💖 Support This Project

Quick Start

1. Install in your AI app

2. Enable Obsidian API (Optional - for full features)

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

Похожие MCP-сервера

smith-and-web/obsidian-mcp-server

MarkusPfundstein/mcp-obsidian

bitbonsai/mcp-obsidian

aliasunder/vault-cortex

rps321321/obsidian-mcp-pro

mlorentedev/hive