Skip to main content
Glama
acbrewer12

Obsidian Vault MCP

by acbrewer12

Obsidian Vault MCP(無料、カード不要、常時稼働のコンピュータ不要)

これにより、Claude(モバイル、デスクトップ、ウェブ)があなたのObsidian vaultに読み取りアクセスできるようになります。 Renderで無料ホスティングされる小さなサーバーを介し、GitHubリポジトリから直接読み取ります。 vaultは、Obsidian Gitプラグインを介してスマートフォンとデスクトップからGitHubに同期されます。電源を入れ続ける必要はありません。

構成要素

  • GitHubリポジトリ — vaultの信頼できる情報源(無料、プライベート)。

  • Obsidian Gitプラグイン — デスクトップとスマートフォンから自動コミット/プッシュ/プルを行います。

  • このMCPサーバー — GitHubのAPIを介してリポジトリを読み取り、list_notes、read_note、search_notesをMCP経由で公開します。Renderに無料デプロイ。

  • Graphify — オプションで、ローカルで実行し、その出力を他のメモと同様にリポジトリにコミットします。

Related MCP server: Obsidian MCP Server

1. GitHubリポジトリを作成する

  1. github.com → New repository → 例: obsidian-vault と名前を付け → Private → Create。

  2. Settings → Developer settings → Personal access tokens → Fine-grained token:

    • Repository access: このリポジトリのみ。

    • Permissions: Contents → Read and write(Claudeがメモを作成および編集できるようにするため、読み取りだけでなく書き込みも必要)。

    • トークンをコピーします — Renderで GITHUB_TOKEN として貼り付けます。

2. Obsidian Gitをセットアップする(デスクトップ + スマートフォン)

  1. Obsidian → Settings → Community plugins → 閲覧 → Obsidian Git をインストール。

  2. vaultフォルダをリポジトリのローカルクローンにポイントする(またはその場で git init し、GitHubリポジトリを origin として追加する)。

  3. プラグイン設定で、auto backup on interval(例: 10分ごと)と auto pull on load をオンにします — 自動的にコミット + プッシュ + プルを行います。

  4. スマートフォンの場合: Obsidianモバイルをインストールし、同じプラグインを追加(iOS/Androidで動作します)、プラグインの認証画面でGitHubにサインインします。

これで、すべてのデバイスが同じリポジトリにプッシュ/プルするようになります。そのリポジトリが同期レイヤーです。

3. MCPサーバーをRenderにデプロイする(無料)

  1. このフォルダ(server.js、package.json、render.yaml)を、独自の公開または非公開のGitHubリポジトリ(vaultリポジトリとは別)にプッシュします。

  2. render.com → New → Web Service → そのリポジトリを接続。

  3. render.yaml を自動検出するはずです。しない場合: Build command npm install、Start command npm start、プラン Free。

  4. 環境変数を追加:

    • GITHUB_TOKEN — ステップ1の fine-grained token

    • GITHUB_OWNER — あなたのGitHubユーザー名

    • GITHUB_REPO — あなたのvaultリポジトリ名(例: obsidian-vault)

    • GITHUB_BRANCH — main(またはデフォルトブランチ)

    • MCP_SHARED_SECRET — ランダムな文字列を作成; これにより、あなたのRender URLを見つけた見知らぬ人がvaultを読むのを防ぎます

  5. デプロイ。https://obsidian-vault-mcp.onrender.com のようなURLが発行されます。

無料ティアに関する注意: 約15分間アイドル状態が続くとスリープし、次のリクエストで起動するのに数秒かかります — たまのClaudeクエリには問題ありません。

4. Claudeに接続する

Claude → Settings → Connectors → Add custom connector:

  • URL: https://<あなたのアプリ>.onrender.com/mcp

  • Header: Authorization: Bearer <あなたの MCP_SHARED_SECRET>

その後、Claudeにメモの検索、読み取り、編集を依頼するだけで、自動的に search_notes / read_note / list_notes / write_note / delete_note が呼び出されます。書き込みはリポジトリに直接コミットされるため、次回Obsidian Gitが同期するときにスマートフォン/デスクトップに表示されます(または、auto-pull-on-intervalがオンになっている場合は即座に表示されます)。

書き込みに関する注意: write_note はファイル全体を上書きします — 既存のメモを編集する場合は、まずClaudeに読み取らせ、その後、更新された完全なコンテンツを書き戻させてください。delete_note は実際の永続的なgitコミットです。削除する前にClaudeに確認を求めることをお勧めします。

5. Graphify — 自動、無料、ホスティング不要

Graphifyはメモからナレッジグラフを構築します。セマンティック抽出にはLLMが必要で、ホスティングが不要な無料オプションはGoogleのGemini API 無料ティア(クレジットカード不要、期限切れなし)です。

無料のGeminiキーを取得する:

  1. aistudio.google.comにアクセスし、Googleアカウントでサインインします。

  2. Get API key → Create API key。コピーします。

GitHub Actionsワークフローを追加する:

  1. あなたのvaultリポジトリで、.github/workflows/graphify.yml を作成し、このプロジェクトの vault-workflow/.github/workflows/graphify.yml の内容を記述します。

  2. リポジトリ → Settings → Secrets and variables → Actions → New repository secret:

    • Name: GEMINI_API_KEY

    • Value: AI Studioのキー

  3. リポジトリ → Settings → Actions → General → Workflow permissions → Read and write permissions に設定(ワークフローがグラフをコミットして戻せるようにするため)。

  4. 1日に1回自動的に実行され、vaultに変更をプッシュするたびにも実行されます。リポジトリの Actions タブから手動でトリガーすることもできます。

これにより、vaultリポジトリ内に graphify-out/graph.json と graphify-out/GRAPH_REPORT.md が生成されます — サーバー、Space、実行し続けるものは一切不要です。

MCPサーバーにはすでにそのためのツールがあります(graph_overview、graph_find_node、graph_neighbors) — read_note と同じようにGitHubから直接グラフを読み取ります。デプロイするものは追加で何もありません; 更新された server.js をRenderに再デプロイするだけで、次回Claudeが接続するときに表示されます。

ローカルテスト(オプション、デプロイ前)

npm install
GITHUB_TOKEN=xxx GITHUB_OWNER=you GITHUB_REPO=obsidian-vault npm start

その後、MCPクライアントを使用して http://localhost:3000/mcp にPOSTするか、Renderに直接デプロイしてClaude経由でテストします。

Related MCP Connectors

Related MCP Servers