
jmilinovich/grove
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
Git-backed Obsidian vault 上で MCP サーバーをオープンソース化。 シングルユーザー、セルフホスト。 6つのツール, ハイブリッド検索, 実証/非難, 自動リンクの発見.
概要
6つのツール、1つのgit-backedボルト、シングルユーザー。 Claude、ChatGPT、Cursor、または任意のMCP互換クライアントは、構造化されたアクセスを接続し、取得します — 検索、読み、書き込みバック、グラフ診断。 vault は、 git repo のマークダウンファイル、バージョンアップされたファイルを永遠に保持します。 Grove はホスト製品 2026-04 → 2026-05 だった。 あなたが探しているレポは、その外に出てきたオープンソースの大聖堂です。 オブシディアンボルト、シングルユーザー、セルフホスト上の個人MCP層。 マルチテナントSaaSレイヤー、オートノマイズエージェントレイヤー、暗号化、トレイル、ウェイトリスト、および管理者ポータルはすべて除去されています。 完全な歴史のためにRETROSPECTIVE.mdを参照してください。 書き込みは git commit です。 あらゆるコミットは、既定のトレーラーを blame を介して読み込まれたパス面に運ぶことができるので、将来の読者は、ユーザーの立っている思考と AI の瞬間インタイム合成を知っています.
概要(AI 翻訳)
Obsidian vaultの検索と任意のAIクライアントから書き込み可能なMCPサーバーを開く。
6つのツール、1つのgit-backedボルト、シングルユーザー。 Claude、ChatGPT、Cursor、または任意のMCP互換クライアントは、構造化されたアクセスを接続し、取得します — 検索、読み、書き込みバック、グラフ診断。 vault は、 git repo のマークダウンファイル、バージョンアップされたファイルを永遠に保持します。
このリポジトリについて Grove はホスト製品 2026-04 → 2026-05 だった。 リポ あなたが見ているのは、それが出てきたオープンソースの大聖堂です: Obsidianのボルト、単一ユーザー、自己ホスト上の個人的なMCPの層。 ザ・オブ・ザ・ 多テナントSaaS層、オートノマイズエージェント層、暗号化、トレイル、 ウェイトリスト、管理者ポータルはすべてストライプされています。
RETROSPECTIVE.mdを参照してください。 完全な歴史のため。
お問い合わせ
6つのツール
| ツール | お問い合わせ |
お問い合わせ
| [query | ハイブリッドBM25 + ベクトル+ RRF融合によるタイトル検索 順位付けされたスニペットをURLで返します。 |
| [get | パスやタイトルでメモを読んでください。 セグメント毎の実績(耐久性と鮮明な声)
| [multi_get | 群馬やコンマ区切りの経路で一括読み込み お問い合わせ
| [write_note | クリエイト / アップデート / ソフト削除 / ハードディスク / ノートを動かす シングルオプ・バッチ(アトミックオプション) |
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
Grove
Open-source MCP server that makes your Obsidian vault searchable and writable from any AI client.
Six tools, one git-backed vault, single-user. Claude, ChatGPT, Cursor, or any MCP-compatible client connects and gets structured access — search, read, write-back, graph diagnostics. Your vault stays yours: markdown files in a git repo, versioned forever.
┌─────────────────────────────────────────────────────────┐
│ MCP client (Claude / Cursor / …) │
└──────────────────────┬──────────────────────────────────┘
│ MCP — Streamable HTTP + Bearer
▼
┌─────────────────────────────────────────────────────────┐
│ grove-server │
│ 6 tools · write queue · provenance · discovery │
└──────────────────────┬──────────────────────────────────┘
│
┌──────────┼──────────┐
▼ ▼ ▼
Hybrid Vault Discovery
Search (git) worker
BM25+Vec (extract → link)
About this repo. Grove was a hosted product 2026-04 → 2026-05. The repo you’re looking at is the open-source cathedral that came out of it: a personal MCP layer over an Obsidian vault, single-user, self-host. The multi-tenant SaaS layer, autonomous-agent layer, encryption, trails, waitlist, and admin portal have all been stripped. See
RETROSPECTIVE.mdfor the full history.
The six tools
| Tool | What it does |
|---|---|
query |
Hybrid BM25 + vector + title search with RRF fusion. Returns ranked snippets with URLs. |
get |
Read a note by path or title. Surfaces per-segment provenance (durable vs perishable voice). |
multi_get |
Batch read via glob or comma-separated paths. |
write_note |
Create / update / soft-delete / hard-delete / move a note. Single op or batch (atomic optional). |
list_notes |
List notes matching a pattern. Optional alias resolution. |
vault_status |
Health, history, diagnostics, graph, lifecycle digest, discovery state, perf counters. |
Every write is a git commit. Every commit can carry provenance trailers that the read path surfaces via blame so future readers know what’s the user’s standing thinking vs an AI’s moment-in-time synthesis.
Quick start
You need:
- Node ≥ 22
- A git-backed Obsidian-style markdown vault on disk
- A QMD index for the vault (Grove reads BM25 + vector hits from it)
- A Voyage AI API key for per-write embeddings (
voyage-4-large)
git clone https://github.com/jmilinovich/grove.git
cd grove
npm install
Set the env vars:
export GROVE_VAULT=/path/to/your/vault # absolute path to the git repo
export GROVE_API_KEY=$(openssl rand -hex 32) # your bearer token — keep secret
export VOYAGE_API_KEY=... # Voyage AI key for embeddings
インストール
npx tsx src/server.ts