Obsidian Vault MCP

ローカルの Obsidian ボールトへの制御されたアクセスを AI エージェントに提供する HTTP Model Context Protocol サーバー。

マークダウンノートの一覧表示、読み取り、検索、作成、更新、名前変更、および慎重な削除を必要とするエージェントランタイム（Grok ボット、Claude、OpenClaw、カスタム MCP クライアント）向けに構築されています。

機能

• ストリーミング可能な HTTP MCP エンドポイント（/mcp）

• Bearer / API キー認証

• ボールト全体モード（ALLOWLIST=*）またはフォルダーの許可リスト

• 読み取りツール: list_notes、list_folder、read_note、search_notes

• 書き込みツール: create_note、append_note、update_note、create_folder、rename_path、delete_path

• .obsidian、.git、ドットファイル、.env、およびキー素材をブロック

• アトミック書き込み + サイズ制限

• 運用向けヘルスチェックエンドポイント: /healthz

Related MCP server: obsidian-autom8

クイックスタート

npm install
export VAULT_ROOT="/absolute/path/to/your/vault"
export BEARER_TOKEN="$(openssl rand -hex 32)"
export ALLOWLIST="*"
export WRITE_ALLOWLIST="*"
export MODE="read-write"
export PORT=8790
export BIND=127.0.0.1
export PUBLIC_BASE="http://127.0.0.1:8790"
npm start

ヘルスチェック:

curl -s http://127.0.0.1:8790/healthz | jq .

環境変数

受け入れられる認証ヘッダー:

• Authorization: Bearer <token>

• X-Api-Key: <token>

• X-Obsidian-Token: <token>

MCP ツール

読み取り

• list_notes — マークダウンパスを一覧表示（プレフィックスはオプション）

• list_folder — ファイル/ディレクトリを一覧表示（recursive はオプション）

• read_note — 1 つのノート + シンプルな frontmatter を読み取り

• search_notes — 大文字小文字を区別しない部分文字列検索

書き込み（MODE=read-write の場合）

• create_note — マークダウンノートを作成（overwrite はオプション）

• append_note — ノートに追記

• update_note — ノート全体を置き換え

• create_folder — フォルダーツリーを作成

• rename_path — ファイルまたはフォルダーの名前変更/移動

• delete_path — マークダウンファイルまたはフォルダーを削除（空でない場合は recursive）

安全性:

• .obsidian、.git、隠しパス、.env、またはキーファイルを提供しない

• 書き込みは .md / .markdown / .txt に限定

• 保護されたトップレベル構造アンカーは一括削除できない

• ボールトやこのサーバー設定にシークレットを置かず、git にコミットしないこと

リバースプロキシの例（nginx）

location ^~ /obsidian-mcp/ {
  proxy_pass http://127.0.0.1:8790/;
  proxy_http_version 1.1;
  proxy_set_header Host $host;
  proxy_set_header Authorization $http_authorization;
  proxy_set_header X-Api-Key $http_x_api_key;
  proxy_buffering off;
}

HTTPS 経由でのみ公開し、Node.js プロセスでは BIND=127.0.0.1 のままにしてください。

Grok / エージェントプロンプトスニペット

You have MCP tools for an Obsidian vault via obsidian-vault-mcp.

Rules:
1. First call list_folder path="" to see top-level structure.
2. Read OBSIDIAN-STRUCTURE.md if present before reorganizing.
3. Prefer append_note for changelogs; do not rewrite history casually.
4. Create notes only as .md under clear topic folders.
5. Never store secrets, tokens, private keys, or .env values.
6. Use search_notes before creating near-duplicate docs.
7. Use rename_path to organize; use delete_path only for clearly obsolete drafts.

セキュリティに関する注意

• このサーバーは強力です。BEARER_TOKEN はパスワードのように扱ってください。

• 本番環境ではネットワーク分離 + リバースプロキシ認証を推奨します。

• ボールト全体の書き込みモードは、信頼できる内部エージェント向けに意図的に設けられています。信頼度の低いボットには WRITE_ALLOWLIST を厳格にしてください。

• .env、トークン、実際のボールトの内容をコミットしないでください。

ライセンス

MIT