EO

ebullient/obsidian-vault-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

43 stars 7 forks Качество 76 Тренд 32MIT

Инструмент MCP, позволяющий Open WebUI или Claude Desktop извлекать файлы из вашего хранилища

Обзор

Этот плагин Obsidian запускает сервер MCP (Model Context Protocol) непосредственно внутри Obsidian, позволяя внешним инструментам LLM получить доступ к вашему хранилище. Поддерживает перенос HTTP (Open WebUI, удаленные LLM). Дополнительный скрипт моста обеспечивает переход от HTTP к stdio (Claude Desktop). Этот плагин запускает локальный HTTP-сервер на вашей машине для приема входящих MCP-соединений. Он не отправляет ваши данные хранилища во внешние службы LLM самостоятельно. - : Этот плагин позволяет вам управлять доступом к хранилищам через API Obsidian и направлять ACL, а не предоставлять внешним инструментам прямой доступ к файловой системе. - : Этот плагин требует среды рабочего стола и не будет работать на мобильных устройствах.

Обзор (машинный перевод)

Этот плагин Obsidian запускает сервер MCP (Model Context Protocol) непосредственно внутри Obsidian, позволяя внешним инструментам LLM получить доступ к вашему хранилище. Поддерживает перенос HTTP (Open WebUI, удаленные LLM). Дополнительный скрипт bridge обеспечивает переход от HTTP к stdio (Claude Desktop).

Важные заметки

** Использование сети**: Этот плагин запускает локальный HTTP-сервер на вашей машине для приема входящих MCP-соединений. Он не отправляет ваши данные хранилища во внешние службы LLM самостоятельно. ** Конфиденциальность**: Этот плагин позволяет вам управлять доступом к хранилищам через API Obsidian и направлять ACL, а не предоставлять внешним инструментам прямой доступ к файловой системе. Только рабочий стол: Этот плагин требует среды рабочего стола и не будет работать на мобильных устройствах.

Особенности

HTTP-сервер MCP: запускает сервер Fastify, реализующий протокол MCP Индикатор стойки бара: показывает статус сервера (остановка/запуск/ошибка) с функцией click-to-toggle Настраиваемые настройки: Настройка порта сервера, поведение автозапуска, регистрация и путь ACL для управления доступом к областям вашего хранилища ** Поддержка CORS**: Возможность доступа с удаленных машин через Tailscale или локальную сеть

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Vault as MCP

This Obsidian plugin runs an MCP (Model Context Protocol) server directly inside Obsidian, letting external LLM tools access your vault. Supports HTTP transport natively (Open WebUI, remote LLMs). An optional bridge script provides a bridge from HTTP to stdio (Claude Desktop).

Important Notes

  • Network Use: This plugin runs a local HTTP server on your machine to accept inbound MCP connections. It does not send your vault data to external LLM services by itself.
  • Privacy: This plugin lets you control vault access through Obsidian APIs and path ACLs instead of giving external tools direct filesystem access.
  • Desktop Only: This plugin requires a desktop environment and will not work on mobile devices.

Features

  • HTTP-based MCP server: Runs a Fastify server implementing the MCP protocol
  • Status Bar Indicator: Shows server status (stopped/running/error) with click-to-toggle functionality
  • Configurable Settings: Adjust server port, auto-start behavior, logging, and path ACLs to control access to areas of your vault
  • CORS Support: Enables access from remote machines via Tailscale or local network
  • MCP Tools: Read, search, list, create, edit, rename, and delete notes; templates and periodic notes — see MCP Tools Reference

Installation

Community Plugins

  1. Open Settings → Community Plugins
  2. Click “Browse” and search for “Vault as MCP”
  3. Install and enable the plugin

Manual Installation

  1. Download the latest release from GitHub
  2. Extract the files to your vault’s .obsidian/plugins/vault-as-mcp/ directory
  3. Reload Obsidian
  4. Enable “Vault as MCP” in Settings → Community Plugins

Install with BRAT

Assuming you have the BRAT plugin installed and enabled:

  1. Open BRAT plugin settings
  2. Click ‘Add beta plugin’
  3. Use https://github.com/ebullient/obsidian-vault-mcp as the URL, select the latest version and install
  4. Enable “Vault as MCP”, either as part of installing via BRAT, or in Settings → Community Plugins

Usage

Starting the Server

The plugin provides three ways to control the server:

  1. Status Bar: Click the status indicator in the bottom-right to toggle the server on/off
  2. Commands: Use the command palette to:
    • Start MCP server
    • Stop MCP server
    • Restart MCP server
  3. Auto-start: Enable in settings to automatically start the server when Obsidian loads

Configuration

Open Settings → Vault as MCP:

  • Server Port: Port number for the MCP server (default: 8765)
  • Bearer Token: Optional authentication token for secure access
  • Auto-start Server: Automatically start when Obsidian loads
  • Debug: Enable debug messages

Authentication

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "obsidian-vault": { "command": "node", "args": ["/absolute/path/to/mcp-bridge.js"], "env": { "VAULT_MCP_URL": "http://localhost:8765/mcp" } } } }