Obsidian MCP Server
Сервер Obsidian MCP
Сервер MCP (Model Context Protocol), который позволяет агентам ИИ выполнять сложный поиск и анализ знаний в вашем хранилище Obsidian с помощью плагина Local REST API.
Почему это важно
Этот сервер преобразует ваше хранилище Obsidian в мощную базу знаний для агентов ИИ, позволяя выполнять сложные многоэтапные рабочие процессы, такие как:
«Извлеките заметки из моей папки «Проекты/Планирование», содержащие в заголовках слова «дорожная карта» или «хронология», созданные после 1 апреля, затем проанализируйте их на предмет наличия блокировщиков или зависимостей и представьте консолидированную оценку рисков со ссылками на исходные заметки»
«Найдите все заметки с тегами «исследование» или «анализ» за последний месяц, просмотрите их содержимое на предмет незавершенных разделов или открытых вопросов, затем сравните с моими заметками «Команда/Экспертиза», чтобы предложить коллегам, которые могли бы помочь заполнить каждый пробел»
«Получить полное содержание заметок о встречах из «Руководства/Ежеквартально», содержащих «бюджет» или «численность персонала», проанализировать их на предмет пунктов действий, назначенных моему отделу, и создать хронологическую временную шкалу со ссылками на исходные заметки»
Расширенные возможности фильтрации сервера, поддержка регулярных выражений и полный поиск контента позволяют агентам выполнять тонкую работу по обработке знаний, на которую вручную ушли бы часы.
Related MCP server: Obsidian Local REST API MCP Server
Предпосылки
Установите плагин Obsidian Local REST API в хранилище Obsidian
Настройте и включите плагин в настройках Obsidian
Запишите URL-адрес API (по умолчанию:
https://localhost:27124) и ключ API, если вы его установили.
Установка
Из PyPI (рекомендуется)
# Install from PyPI
pip install obsidian-api-mcp-server
# Or with uv
uv pip install obsidian-api-mcp-serverДобавить в конфигурацию MCP
Добавьте в конфигурацию вашего клиента MCP (например, Claude Desktop):
{
"mcpServers": {
"obsidian-api-mcp-server": {
"command": "uvx",
"args": [
"--from",
"obsidian-api-mcp-server>=1.0.1",
"obsidian-api-mcp"
],
"env": {
"OBSIDIAN_API_URL": "https://localhost:27124",
"OBSIDIAN_API_KEY": "your-api-key-here"
}
}
}
}Из источника (Разработка)
# Clone the repository
git clone https://github.com/pmmvr/obsidian-api-mcp-server
cd obsidian-api-mcp-server
# Install with uv
uv pip install -e .
# Or with pip
pip install -e .Конфигурация
Установите переменные среды для Obsidian API:
# Required: Obsidian API URL (HTTPS by default)
export OBSIDIAN_API_URL="https://localhost:27124" # Default
# Optional: API key if you've configured authentication
export OBSIDIAN_API_KEY="your-api-key-here"Важное примечание по безопасности : Избегайте жесткого кодирования OBSIDIAN_API_KEY непосредственно в скриптах или передачи его в систему контроля версий. Рассмотрите возможность использования файла .env (который включен в .gitignore этого проекта) и библиотеки, например python-dotenv для управления вашим ключом API или используйте переменные среды, управляемые вашей операционной системой или оболочкой.
Примечание : сервер по умолчанию использует HTTPS и отключает проверку сертификатов SSL для самоподписанных сертификатов, обычно используемых с локальными экземплярами Obsidian. Для HTTP-подключений установите OBSIDIAN_API_URL="http://localhost:27123" .
Использование
Запустите сервер MCP:
obsidian-mcpДоступные инструменты
Сервер предоставляет три мощных инструмента:
search_vault— Расширенный поиск с гибкими фильтрами и полным извлечением контента:query— поиск текста или регулярного выражения по содержимому заметки (необязательно)query_type- Тип поиска: «текст» (по умолчанию) или «регулярное выражение»search_in_path— Ограничить поиск определенным путем к папкеtitle_contains— Фильтр по тексту в заголовках заметок (строка, массив или строка JSON)title_match_mode— Как сопоставить несколько терминов: «любой» (ИЛИ) или «все» (И)tag— фильтр по тегу (строка, массив или строка JSON — поиск по заголовкам и встроенным #тегам)tag_match_mode— Как сопоставить несколько тегов: «любой» (ИЛИ) или «все» (И)context_length— объем возвращаемого контента (установите высокое значение для полного контента)include_content— логическое значение для извлечения полного содержимого всех соответствующих заметок.created_since/until- Фильтр по дате созданияmodified_since/until- Фильтр по дате измененияpage_size- Результаты на страницуmax_matches_per_file— ограничение совпадений на одну заметку
Основные характеристики :
Если
queryне указан, автоматически возвращается полный контент для поиска только с фильтром.include_content=Trueпринудительно извлекает полный контент для любого поискаПоддерживает шаблоны регулярных выражений для сложного сопоставления текста (условия ИЛИ, поиск без учета регистра и т. д.)
get_note_content— Извлечь полное содержимое и метаданные определенной заметки по путиbrowse_vault_structure— эффективная навигация по структуре каталогов хранилища:path— каталог для просмотра (по умолчанию — корень хранилища)include_files— логическое значение для включения файлов (по умолчанию: False, только папки для скорости)recursive- Булевский для просмотра всех вложенных каталогов
Примеры использования
Базовые поиски
Найти заметки по названию в определенной папке:
search_vault( search_in_path="Work/Projects/", title_contains="meeting" )Найти заметки с несколькими терминами в заголовках (логика ИЛИ):
search_vault( title_contains=["foo", "bar", "fizz", "buzz"], title_match_mode="any" # Default )Найти заметки со ВСЕМИ терминами заголовка (И логикой):
search_vault( title_contains=["project", "2024"], title_match_mode="all" )Получить все последние заметки с полным содержанием:
search_vault( modified_since="2025-05-20", include_content=True )Текстовый поиск с контекстом:
search_vault( query="API documentation", search_in_path="Engineering/", context_length=500 )Поиск по тегу:
search_vault( tag="project" )Поиск регулярных выражений для условий OR:
search_vault( query="foo|bar", query_type="regex", search_in_path="Projects/" )Поиск регулярных выражений для задач, назначенных конкретным людям:
search_vault( query="(TODO|FIXME|ACTION).*@(alice|bob)", query_type="regex", search_in_path="Work/Meetings/" )
Расширенные многошаговые рабочие процессы
Эти примеры демонстрируют, как агенты могут объединять сложные задачи по обнаружению знаний:
Стратегический анализ проекта:
# Step 1: Get all project documentation search_vault( search_in_path="Projects/Infrastructure/", title_contains=["planning", "requirements", "architecture"], title_match_mode="any", include_content=True ) # Step 2: Find related technical discussions search_vault( tag=["infrastructure", "technical-debt"], tag_match_mode="any", modified_since="2025-04-01", include_content=True )Затем агент может анализировать зависимости, выявлять риски и рекомендовать распределение ресурсов.
Майнинг элементов действия встречи:
# Get all recent meeting notes with full content
search_vault(
search_in_path="Meetings/",
title_contains=["standup", "planning", "retrospective"],
title_match_mode="any",
created_since="2025-05-01",
include_content=True
)Агент сканирует контент на предмет элементов действий, извлекает задания и создает хронологическое отслеживание.
Анализ пробелов в исследованиях:
# Find research notes with questions or gaps
search_vault(
query="(TODO|QUESTION|INVESTIGATE|UNCLEAR)",
query_type="regex",
tag=["research", "analysis"],
tag_match_mode="any",
include_content=True
)
# Cross-reference with team expertise
search_vault(
search_in_path="Team/",
tag=["expertise", "skills"],
tag_match_mode="any",
include_content=True
)Агент выявляет пробелы в знаниях и предлагает членов команды, которые могли бы помочь
Исследование структуры хранилища:
# Quick organizational overview
browse_vault_structure(recursive=True)
# Deep dive into specific areas
browse_vault_structure(
path="Projects/CurrentSprint/",
include_files=True,
recursive=True
)Картирование знаний на основе тегов:
# Find notes with multiple tags (AND logic)
search_vault(
tag=["project", "urgent"],
tag_match_mode="all",
include_content=True
)
# Find notes with any relevant tags (OR logic)
search_vault(
tag=["architecture", "design", "implementation"],
tag_match_mode="any",
modified_since="2025-04-15"
)Разработка
# Install with test dependencies
uv pip install -e ".[test]"
# Run the server
python -m obsidian_mcp.server
# Run tests
uv run behave features/blackbox_tests.feature
# Or use the test runner
python run_tests.pyЛицензия
Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .
Available Tools
3 toolsbrowse_vault_structureARead-only
Browse vault directory structure.
Args:
path: Path to browse from (defaults to vault root)
include_files: Include files in listing (default: False, folders only)
recursive: List nested contents recursively
Inputs: include_files, path, recursive.
get_note_contentARead-only
Get the full content and metadata of a specific note by path.
Args:
path: Full path to the note within the vault
Inputs: path (required).
search_vaultARead-only
Search Obsidian vault for notes matching criteria.
Args:
query: Text or regex pattern to search for
query_type: "text" or "regex"
search_in_path: Limit search to specific folder
title_contains: Filter by title (string or array)
title_match_mode: "any" or "all" for multiple title terms
tag: Filter by tag (string, array, or JSON string like title_contains)
tag_match_mode: "any" or "all" for multiple tag terms
context_length: Characters of context around matches
include_content: Return full note content
modified_since/until: Filter by modification date (YYYY-MM-DD)
created_since/until: Filter by creation date (YYYY-MM-DD)
page_size/page: Pagination controls
max_matches_per_file: Limit matches per file
Inputs: context_length, created_since, created_until, include_content, +12 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: browse_vault_structure is for exploring the file hierarchy, get_note_content retrieves a specific note's details, and search_vault performs complex queries across the vault. There is no overlap in functionality, making it easy for an agent to select the right tool.
All tool names follow a consistent verb_noun pattern with snake_case: browse_vault_structure, get_note_content, and search_vault. The naming is predictable and readable, with no deviations in style or convention.
With only 3 tools, the server feels thin for managing an Obsidian vault, which typically involves operations like creating, updating, or deleting notes. While the tools cover browsing, reading, and searching, the lack of write operations limits the scope, making it borderline for the domain.
The tool set is severely incomplete for an Obsidian vault management server. There are no tools for creating, updating, or deleting notes, which are core CRUD operations. This creates significant gaps that will likely cause agent failures when trying to perform basic note management tasks.
Maintenance
Related MCP Connectors
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Search your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseBqualityFmaintenanceA server that consolidates 21+ Obsidian tools into 5 intelligent operations (vault, edit, view, workflow, system) with contextual workflow hints to help AI agents effectively interact with Obsidian.536MIT
- AlicenseAqualityBmaintenanceA bridge server that allows LLM tools to interact with an Obsidian vault through a local REST API, enabling file operations, note management, and metadata access through natural language.1349 npm9MIT
- AlicenseAqualityDmaintenanceEmpowers AI agents to deeply understand and interact with Obsidian vaults through the Local REST API, enabling advanced features like vault structure discovery, graph analysis, command execution, and batch file operations.1618MIT
- AlicenseNot gradedqualityDmaintenanceA high-performance TypeScript server that enables interaction with Obsidian vaults through the Local REST API community plugin. It provides comprehensive tool discovery, intelligent resource caching, and unified access to both markdown notes and binary vault files like images and PDFs.5MIT