JG

jmilinovich/grove

Developer tools

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

22 stars 2 forks 品質 69 トレンド 30MIT

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.md for 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
GitHub で README 全文を見る

インストール

npx tsx src/server.ts
MCP 初心者?mcpskill.org のガイドから始めましょう →