ebullient/obsidian-vault-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

43 stars 7 forks 品質 76 トレンド 32MIT

Repository Install

MCP ツールにより、WebUI または Claude デスクトップを開き、 vault からファイルを取得できます

概要

この Obsidian プラグインは、Obsidian 内の MCP (Model Context Protocol) サーバーを直接実行し、外部の LLM ツールが vault にアクセスできるようにします。 HTTP トランスポートをネイティブ(WebUI、リモート LLM を開く)でサポートします。ブリッジスクリプトは、HTTP から stdio (Claude Desktop) までのブリッジを提供します。 - : このプラグインは、マシン上でローカル HTTP サーバを実行して、インバウンド MCP 接続を受け付けます。外部LMサービスに悪質データを送信しません。 - : このプラグインを使用すると、外部ツールの直接ファイルシステムアクセスを与える代わりに、Obsidian API とパス ACL を介して vault アクセスを制御することができます。 - : このプラグインはデスクトップ環境を必要とし、モバイルデバイスでは動作しません.

概要（AI 翻訳）

この Obsidian プラグインは、Obsidian 内の MCP (Model Context Protocol) サーバーを直接実行し、外部の LLM ツールが vault にアクセスできるようにします。 HTTP トランスポートをネイティブ(WebUI、リモート LLM を開く)でサポートします。 bridge スクリプトは HTTP から stdio (Claude Desktop) までのブリッジを提供します。

重要な注意事項 ツイート

ネットワーク使用: このプラグインは、マシン上でローカル HTTP サーバを実行して、インバウンド MCP 接続を受け付けます。外部LMサービスに悪質データを送信しません。

プライバシー: このプラグインを使用すると、外部ツールの直接ファイルシステムアクセスを与える代わりに、Obsidian API とパス ACL を介して vault アクセスを制御することができます。

デスクトップのみ: このプラグインはデスクトップ環境を必要とし、モバイルデバイスでは動作しません。

##特徴

** HTTP ベースの MCP サーバー**: MCP プロトコルを実装する Fastify サーバを実行します。
Status Barインジケータ: クリックトグル機能でサーバーの状態(停止/実行/エラー)を表示 -Configurable Settings:サーバーポートの調整、自動起動動作の調整、ロギング、およびVaultの領域へのアクセスの制御 -CORSサポート:テールスケールまたはローカルネットワークを介してリモートマシンからアクセス可能

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

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

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

Manual Installation

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

Install with BRAT

Assuming you have the BRAT plugin installed and enabled:

Open BRAT plugin settings
Click ‘Add beta plugin’
Use https://github.com/ebullient/obsidian-vault-mcp as the URL, select the latest version and install
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:

Status Bar: Click the status indicator in the bottom-right to toggle the server on/off
Commands: Use the command palette to:
- Start MCP server
- Stop MCP server
- Restart MCP server
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

GitHub で README 全文を見る

インストール

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"
         }
       }
     }
   }